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The Amstrad CPC Firmware Guide 


Introduction 


Fortunately, when Amstrad developed the CPC and CPC+ computers, they let the 
user access many of the computer's internal routines (the firmware) and use them in 
their own programs. Experienced coders will no doubt write faster or more versatile 
code, yet these can easily be patched in using the Firmware Jumpblock. 


For many years, Amstrad produced the definitive guide to the insides of the CPC but 
sale of this was stopped in 1989. Since then the Firmware Manual has been a much 
sought-after item by programmers. Nevertheless, the original guide had some 
omissions, notably the abscence of information on the system variables and the Z80 
microprocessor inside every CPC and CPC+. 


This guide is not intended to explain how to program in machine code, but we hope 
that it will supply the information needed to make the most of the Amstrad's 
capabilities when writing your own programs. 


Bob Taylor and Thomas Defoe, 1992 
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Use of memory by the 
Operating System 


The following list of memory addresses and their uses has been compiled over a number of years, 
mainly from personal investigation. It does not claim to be definitive, since no accurate source seems 
to be available to the average computer user, and so may be inaccurate or deficient at certain points; 
also, some of the areas described have uses additional to those listed. We have tried to make it as 
accurate as possible, to enable others to use to the full those facilities which present themselves via 
this information. 


e Addresses and values are present in memory with the low byte first. The Z80 processor 
represents all 16-bit values in the order lo-byte hi-byte. 


e The term ‘above' means higher in memory. 


e Areas with numbers of bytes of either &00 or &FF given in brackets, may be safe to use for 
machine code routines etc, as may the tape area, and the Sound ENT and ENT areas if these 
are unused. 


e The first column given is the address (for the 6128) of the memory being considered, while the 
second column gives the equivalent 464 address - unfortunately the 464 differs from the 6128 
for most addresses, so if one address is omitted, the system variable is not available for that 
machine. 


e The next column gives the size allocated in bytes. Addresses on the right hand side enclosed 
in brackets are of System Variables which hold the address of the bytes being explained. With 


addresses or values anywhere in the text, the value shown is for the 6128; a value in italics is 
for the 464 only. 


Overview of the CPC's memory 


In the following tables, the following symbols are used: 


<> - not the value or bit which follows 
* _- this applies to all machine with a disk drive fitted 


bO - bit 0 
b1 - bit 1 
b15 - bit 15 


HB - most significant byte, hi-byte 
LB - least significant byte, lo-byte 


When addresses are given in the comments, they apply to the 6128. When the 464's address is 
different, it is given in brackets, such as at the comment for &B763. 


Please note that this section of the guide has been set out with all the addresses in the leftmost 
column in the correct order for the 6128. 
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The System Variables 


6128 464 Size Comments on the memory locations 
&0000 &0000 &40 Restart block: 
&0000 &0000 RST 0: complete machine reset 
&0008 &0008 RST 1: LOWJUMP: in-line two byte address: b0 to 


b13=address; 
b14=Low ROM disabled; 
b15=Upper ROM disabled 


&000B &000B LOW PCHL: HL has address as RST 1 
&000E &000E “JMP BC': BC has address to jump to 
&0010 &0010 RST 2: SIDE CALL: inline two byte address: b0 to 


b13=address-&C000; 
bl4 to b15=offset to required ROM (used between 
sequenced Foreground ROMs) 


&0013 &0013 SIDE PCHL: HL has address as RST 2 
&0016 &0016 *JMP DE’: DE has address to jump to 
&0018 &0018 RST 3: FAR CALL: inline three byte address block: bytes 1 


and 2 hold the address; 
byte 3 holds the ROM select address 


&001B &001B FAR PCHL: as RST 3, but HL has address; 
C has ROM select 
&001E &001E *JMP HL': HL has address to jump to 
&0020 &0020 RST 4: RAM LAM: LD A,(HL) from RAM with ROMs 
disabled 
&0023 &0023 FAR CALL: as RST 3, but HL has address of three byte 
address block 
&0028 &0028 RST 5: FIRM JUMP: inline two byte address to jump to 
&0030 &0030 RST 6: User restart; 
default to RST 0 
&0038 &0038 RST 7: Interrupt entry (KB/Time etc) 
&003B &003B External interrupt (default to RET) 
&0040 &0040 &130 ROM lower foreground area: BASIC input area (tokenised) 
&016F &016F end of BASIC input area. 
&0170 &0170 BASIC working area for program, variables, etc... 
&0170 &0170 Program area; 


Variables and DEF FNs area; 

Arrays area; 

Free space; 

end of free space; 

Strings area; 

end of Strings area (=HIMEM); 

Space for user machine code routines; 
end of user space, byte before user; 
defined graphics area; 

User defined graphics area; 

end of UDG area; 

ROM Upper reserved area, expandible during; 


KL ROM WALK, including: 


4 ROM chaining blocks (arranged as follows): 
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6128 
&AGFC 
&AGFC 


&AGFE 
&AGFF 
&A700 


&A700 


&A701 
&A702 
&A703 
&A705 
&A706 
&A708 
&A709 


&A709 
&A70A 
&A712 
&A712 
&A713 
&A715 


&A716 
&A718 
&A719 


&A729 


&A72A 
&A72B 
&A72C 
&A72D 


&A72D 
&A72E 
&A736 


&A739 
&A73A 
&A73B 
&A73C 
&A73D 


464 
&AGFC 


&500 


16 


16 


Comments on the memory locations 
AMSDOS chain, ing block: 


address of next ROM block in chain (or &0000 if the last in 
chain) 


ROM Select address 
&00 


AMSDOS reserved area. This area is moved down if any 
ROMs have numbers greater than eight (6128 only) 


Current drive number (0=A; 
1=B) 


Current USER number 

flag? 

address? 

flag? 

address? 

OPENIN flag (&FF=closed; <>&FF=opened) 


Copy of current or last Disc Directory entry for 
OPENIN/LOAD: 


USER number 

filename (padded with spaces) 

file extension (BAS, BIN, BAK, etc) including: 
b7 set = Read Only 

b7 set = System (ie not listed by CAT or DIR) 


16K block sequence number for this directory entry (0 for 
first block; if <>O part of a larger file) 


unused 
length of this block in 128 byte records 


sequence of Disc Block numbers containing file - &00 as 
end marker 


number of 128 byte records loaded so far; before loading 
proper: &00 for ASCII (ie nothing loaded yet); &01 for BIN 
or BAS files (ie header record loaded) 


OPENOUT flag (&FF=closed; <>&FF=opened) 


Copy of current or last Disc Directory entry for 
OPENOUT/SAVE: 


USER number 
filename (padded with spaces) 


file extension ($$$ while open; correct extension when 
finished) 


flag (&00=open; &FF=closed, ie finished) 


flag (&00=open; &FF=closed) 
number of 128 byte records saved so far 


sequence of Disc Block numbers containing file - &00 as 
end marker 
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10 


6128 
&A74D 
&A74E 
&A74F 
&A750 


&A751 


&A753 


&A755 


&A755 
&A756 
&A75E 
&A761 
&A767 


&A768 
&A76A 


&A76C 
&A76D 
&A76F 
&A770 
&A795 
&A798 


&A79A 


&A79B 


&A79D 


&A79F 
&A79F 
&A7A0 
&ATA8 
&A7AB 
&A7AC 
&A7AD 
&A7AE 
&A7B1 


&A7B2 
&A7B4 


464 
&A74D 
&A74E 
&A74F 
&A750 


&A751 


&A753 


&A755 


&A755 
&A756 
&A75E 
&A761 
&A767 


&A768 
&A76A 


&A76C 
&A76D 
&A76F 
&A770 
&A795 
&A798 


&A79A 


&A79B 


&A79D 


&A79F 
&A79F 
&A7A0 
&A7A8 
&A7AB 
&A7AC 
&A7AD 
&A7AE 
&A7Bl 


&A7B2 
&A7B4 


Size 


&45 


Oo oo 


Comments on the memory locations 


number of 128 byte records saved so far 


flag (®200=OPENIN; &01=In Char; &02=In Direct (whole 
file)) 


address of 2K buffer for ASCII, or of start of current/last 
block if BIN or BAS file 


address of next byte to read for ASCII, or of 2K buffer for 
BAS or BIN file 


first &45 bytes of BAS/BIN file (extended header) or of 
extended header made for ASCII file 


USER number 
filename (padded) 
extension 

unused 


file type (&00=BASIC; &01=protected BASIC; &02=Binary; 
&16=ASCIl) 


unused 


address to load file into (=actual destination), or buffer for 
an ASCII file 


unused for disc 

length of file in bytes (&0000 for ASCII files) 

execution address fora BIN file 

unused 

length of actual file in bytes (as &A76D) -BAS and BIN only 


simple checksum of first 67 bytes of header (LB first) - BAS 
and BIN only 


flag (8@00O=OPENOUT; &01=Out Char; &02=Out 
Direct(whole file)) 


address of 2K block if an ASCII file, or of current/last block 
saved if a BAS or BIN file 


address of next byte to write for ASCII files, or of 2K buffer 
for BAS and BIN files 


first &45 bytes of BAS/BIN file (ie extended header) 
USER number 

filename (padded) 

extension 


flag (&00=Open) 


flag (&00=Open) 
unused 


file type (&00=BASIC; &01=protected BASIC; &02=Binary; 
&16=ASCIl) 


unused 


address to save file from (for BAS or BIN files), or of buffer 
for ASCII files 
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6128 
&A7B6 
&A7B7 
&A7B9 
&A7BB 
&A7DF 


&A7E2 


&A7E4 


&A864 


&A88B 


&A890 
&A890 
&A892 
&A893 
&A894 
&A895 
&A897 
&A899 


&A89B 
&A89D 


&A89F 
&A8A0 
&A8A1 
&A8A2 
&A8A3 
&A8A4 
&A8A5 
&A8A6 
&A8A7 
&A8A8 
&A8A9 
&A8B9 
&A8D0 


&A8E9 
&A8F9 
&A900 
&A910 
&A918 


464 
&A7B6 
&A7B7 
&A7B9 
&A7BB 
&A7DF 


&A7E2 


&A7E4 


&A864 


&A88B 


&A890 
&A890 
&A892 
&A893 
&A894 
&A895 
&A897 
&A899 


&A89B 
&A89D 


&A89F 
&A8A0 
&AB8AI 

&A8A2 
&A8A3 
&A8A4 
&A8A5 
&A8A6 
&A8A7 
&A8A8 
&A8A9 
&A8B9 
&A8D0 


&A8E9 
&A8F9 
&A900 
&A910 
&A918 


Size 


NO NO N 


&19 


2 


Comments on the memory locations 
unused for disc 
length of file in bytes 
execution address for BIN files 
unused 


length of actual file in bytes (as at &A7B7) - BAS and BIN 
only 


simple checksum of first 67 bytes of header (LB first) - BAS 
and BIN only 


buffer area for records sent to or loaded from Disc, or used 
in forming filename and extension 


Tape Jumpblock is stored here by AMSDOS - is moved to 
&BC77 etc after [TAPE 


far address used by AMSDOS RST 3s at &BC77 etc 
(&CD30,8&07) 


Drive A Extended Disc Parameter Block (XDPB): 

number of 128 byte records per track 

log2(Block size)-7 (&03=1024 bytes; &04=2048 bytes) 
(Block size)/128-1 (&07=1024 bytes; 

(Block size)/1024 (if total of blocks <256, else /2048)-1 
number of blocks per disc side (excluding reserved tracks) 
number of (directory entries)-1 


bit signiflcant value of number of blocks for directory 
(&0080=1; &00C0=2) 


number of bits in checksum =((&A894)+ 1)/4 


number of reserved tracks (&00=Data; &01=IBM; 
&02=System) 


number of first sector (&01=IBM; &41=System; &C1=Data) 
number of sectors per track (Data=9; System=9; IBM=8) 
gap length (Read/Write) 

gap length (Format) 

format filler byte (&E5) 

log2(sector size)-7 (&02=512; &03=1024) 

records per sector 

current track (not for use) 

0=not aligned (not for use) 


Auto select flag (&00=Auto select; &FF= don't alter) 


Drive B Extended Disc Parameter Block (arranged as at 
&A890) 


(&17 bytes of &FF) 


(&12 bytes of &00) 


address of area for reading directory entries for Drive A 
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12 


6128 
&AIIA 
&A91C 
&AQIE 
&A920 
&A928 
&AQ92A 
&A92C 
&AQ92E 
&A930 
&A9BO 
&ABBO 
&ACO00 
&ACO0 


&AC01 
&ACO02 


&AC04 
&AC06 
&ACO7 
&AC08 


&ACO09 
&ACOA 
&ACOB 
&ACOC 
&ACOD 


&AC12 


&AC14 
&AC16 
&AC17 
&AC18 
&ACIA 

&AC1C 


&AC1E 
&ACIE 


&AC20 
&AC21 


464 
&AIIA 
&A91C 
&AQIE 
&A920 
&A928 
&A92A 
&A92C 
&AQ92E 
&A930 
&A9BO 
&ABBO 
&ACO00 
&ACO00 


&ACO01 
&AC1C 
&AC1D 


&AC1F 
&AC21 
&AC22 


&AC23 
&AC24 
&AC25 


&AC26 
&AC27 


&AC2C 


&AC2E 
&AC30 
&AC31 

&AC32 
&AC34 
&AC36 


&AC38 
&AC38 


&AC3A 
&AC3B 


Size 


&200 


9*3 


Comments on the memory locations 
address of Drive A XDPB 
address of the byte after the end of Drive A XDPB 


(8bytes of &00) 

address of area for reading directory entries for Drive B 
address of Drive B XDPB 

address of the byte after the end of Drive B XDPB 


block of directory entries, including last file loaded 
buffer for loading; usually contains last sector loaded 
(&50 bytes of &00) 

Start of BASIC Operating System reserved area: 


program line redundant spaces flag (O=keep extra spaces; 
<>0=remove) 


groups of 3 RET bytes (&C9) called by the Upper ROM 
AUTO flag (0=off; <>0=on) 


number of the next line (6128) or of the current line (464) 
for AUTO 


step distance for AUTO 


WIDTH (&84=132) 


FOR/NEXT flag (O=NEXT not yet used; <>0=used) 


FOR start value (real). Only 2 bytes are used if % or 
DEFINT variable 


address of *: ' or of the end of program line byte after a 
NEXT command 


address of LB of the line number containing WEND 


WHILE/WEND flag (&41=WEND not yet used; &04=used) 


address of location holding ROM routine address for KB 
event block 


Event Block for ON SQ(1): 


chain address to next event block; &0000 if last in chain, 
but &FFFF if unused 


count 


class: Far address, highest (ON SQ) priority, Normal & 
Synchronous event 
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6128 
&AC22 
&AC24 


&AC25 
&AC26 


&AC28 


&AC2A 


&AC36 


&AC42 
&AC42 


&AC44 
&AC46 
&AC48 
&AC4A 
&AC4B 


&AC4C 
&AC4E 


&AC4F 
&AC50 


&AC52 


&AC54 


&AC6E6 


&AC78 


&AC8A 


&AD8C 
&AD8E 


&AD90 
&AD91 
&AD92 


&AD94 


&AD96 


&AD98 


464 
&AC3C 
&AC3E 


&AC3F 
&AC40 


&AC42 


&AC44 


&AC50 


&AC5C 
&AC5C 


&AC5SE 
&AC60 
&AC62 
&AC64 
&AC65 


&AC6E6 
&AC68 


&AC69 
&AC6A 


&AC6C 


&AC6E 


&AC80 


&AC92 


&ACA4 


&ADA6 
&ADA8 


&ADAA 


&ADAB 


&ADAD 


&ADAF 


&ADB1 


Size 


1 


Comments on the memory locations 
routine address (in BASIC ROM) 


ROM Select number (&FD ie ROM 0 enabled, Lower ROM 
disabled) 


(first byte of user field) 


address of the end of program line byte or °:' after “ON 
SQ(x) GOSUB line number' statement 


address of the end of program line byte of the line before 
the GOSUB routine 


Event block for ON SQ(2), arranged as &AC1E onwards - 
second ON SQ priority 


Event block for ON SQ(4), arranged as &AC1E onwards - 
lowest ON SQ priority 


Ticker and Event Block for AFTER/EVERY Timer 0 


chain address to next event block (usually to another timer 
or &00FF) 


‘count down' count 

recharge count (for EVERY only - &0000 if AFTER) 
chain address to next ticker block 

count 


class: Far address, lowest (timer) priority, Normal and 
Synchronous event 


Routine address (in BASIC ROM) 


ROM Select No (&FD ie ROM 0 enabled, Lower ROM 
disabled) 


(first byte of user field) 


address of the end of program line byte or °:' after 
statement in use when the timer ‘timed-out' 


address of tbe end of program line byte of tbe line before 
the GOSUB routine 


Ticker and Event Block for AFTER/EVERY Timer 1 (3rd 
Timer priority) arranged as at &AC42 


Ticker and Event Block for AFTER/EVERY Timer 2 (2nd 
Timer priority) arranged as at &AC42 


Ticker and Event Block for AFTER/EVERY Timer 3 
(highest priority) arranged as at &AC42 


BASIC input area for lines (as typed in and not tokenised) 
or for INPUT 


address of line number LB in line containing error 


address of byte before statement containing error - ie of *:' 
or of HB of Line No 


ERR (Error No) 
DERR (Disc Error No) 


as &AD8E if error is in a program (ie not if in Direct 
Command Mode) 


as &AD8C if error is in a program (ie not if in Direct 
Command Mode) 


address of the length LB of line specified by the “ON 
ERROR GOTO' command 
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13 


14 


6128 
&AD99 


&AD99 
&AD9A 
&AD9B 
&AD9C 
&AD9IE 
&AD9F 
&ADAO 
&ADA2 


&ADA2 


&ADA3 
&ADA3 


&ADA4 


&ADA5S 


&ADA6 
&ADAQ 
&ADAC 
&ADAF 
&ADB2 
&ADB7 
&ADEB 
&ADED 
&ADF3 


&AE0D 
&AEOE 
&AE10 
&AE12 
&AE14 
&AE15 
&AE17 


&AE19 


&AE1B 


&AE1D 


&AE1F 


464 
&ADB2 


&ADB2 
&ADB3 
&ADB4 
&ADB5 
&ADB7 
&ADB8 
&ADB9 
&ADBB 


&ADBB 


&ADBC 
&ADBC 


&ADBD 


&ADBE 


&ADBF 
&ADC2 
&ADC5 
&ADC8 
&ADCB 
&ADDO 
&AE04 

&AE06 

&AEOC 


&AE26 
&AE27 
&AE29 
&AE2B 
&AE2D 
&AE2E 
&AE30 


&AE32 


&AE34 


&AE36 


&AE38 


Comments on the memory locations 


Current SOUND parameter block (see Firmware Jump 
&BCAA) 


channel andrendezvous status 
amplitude envelope (ENV) number 
tone envelope (ENT) number 

tone period 

noise period 

initial amplitude 

duration, or envelope repeat count 


Current Amplitude or Tone Envelope parameter bloc (see 
&BCBC or &BCBF) 


number of sections (+&80 for a negative ENT number, ie 
the envelope is run until end of sound 


first section of the envelope: 


step count (if <&80) otherwise envelope shape (not tone 
envelope) 


step size (if step count<&80) otherwise envelope period 
(not tone envelope) 


pause time (if step count<&80) otherwise envelope period 
(not tone envelope) 


second section of the envelope, as &ADA3 
third section of the envelope, as &ADA3 
fourth section of the envelope, as &ADA3 


fifth section of the envelope, as &ADA3 


table of DEFINT (&02), DEFSTR (&03) or DEFREAL 
default (&05), for variables ‘a’ to “z' 


address of line number LB of last BASIC line (or &FFFF) 


address of byte before next DATA item (eg comma or 
space) 


address of next space on GOSUB etc stack, (see also 
&BO6F) 


address of byte before current statement (&003F if in 
Direct Command mode) 


address of line number LB of line of current statement 
(&0000 if in Direct Command mode) 


trace flag (O=TROFF; <>0=TRON) 
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6128 
&AE20 


&AE21 

&AE22 
&AE24 
&AE26 
&AE28 
&AE29 
&AE2A 
&AE2C 
&AE2D 


&AE3A 


&AE3A 


&AE3E 


&AE43 
&AE4E 


&AE51 
&AE52 
&AE54 


&AE55 


&AE57 
&AE58 


&AES5A 


&AE5C 
&AE5D 


&AESE 


&AE60 


&AE62 


&AE64 


&AE66 


464 
&AE39 


&AE3A 
&AE3B 
&AE3D 
&AE3F 
&AE41 

&AE42 
&AE43 
&AE45 
&AE46 


&AE53 


&AE53 


&AE57 


&AE5D 
&AE68 


&AE6B 


&AE6E 


&AE81 


&AE83 


Size 


13 


NO 


2 


Comments on the memory locations 


flag used with Trace (&00 if in Direct Command mode; &01 
if in a program) 


address to load cassette file to 


file type from cassette header 
file length from cassette header 
program protection flag (<>0 hides program as if protected) 


buffer used to form binary or hexadecimal numbers before 
printing etc 


start of buffer used to form hexadecimal numbers before 
printing etc 


Key Number used with INKEY (providing the Key Number 
is written as a decimal) 


last byte (usually &00 or &20) of the formed binary or 
hexadecimal number 


buffer used to form decimal numbers before printing etc 


last byte (usually &00 or &20) of the formed decimal 
number 


temporary store for address after using (®AE68) 


address of last used ROM or RSX JUMP instruction in its 
Jump Block 


ROM Select number if address above is in ROM 


BASIC Parser position, moved on to *: °, or the end of 
program line byte after a CALL or an RSX 


the resetting address for machine Stack Pointer after a 
CALL or an RSX 


ZONE value 


HIMEM (set by MEMORY) 


address of the byte before the UDG area (the end of the 
user M/C routine area or the Strings area) if the UDG area 
is still present, otherwise the highest byte of Program etc 
area 


address of highest byte of free RAM (ie last byte of UDG 
area) 


address of start of ROM lower reserved area (used for 
tokenised lines) 


address of end of ROM lower reserved area (byte before 
Program area) 


as &AE68 
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15 


16 


6128 
&AE68 
&AE6A 


&AE6C 


&AE6E 
&AE70 


WHILE 
(66 max 
capacity): 


&BO6F 


&B071 


&B073 
&B075 


464 
&AE85 
&AE87 


&AE89 


&AE8C 


&BO08B 


&B08D 


&BO8F 


&B091 


Size 


&1FF 


+5 


Comments on the memory locations 
address of start of Variables and DEF FNs area 


address of start of Arrays area (where next Variable or 
DEF FN entry is placed) 


address of start of free space (where next Array entry is 
placed) 


GOSUB, FOR and WHILE stack. Entries are added above 
any existing ones in use (mixed as encountered) at 
address given by &BO6F and must be used up in the 
opposite order. Completed entries are not deleted, just 
overwitten by the next new entry: 


(byte of &00) 


address of end of program line byte or *:' after GOSUB 
statement (the point to RETURN to) 


address of line number HB of line containing GOSUB 
byte of &06, ie the length of the GOSUB entry 


address of current value of control variable (in Variables 
area) 


value of limit (ie the TO value) - there are two bytes only for 
Integer FORs 


value of STEP - two bytes for Integer FORs 
sign byte (&00 for positive; &01 for negative) 


address of the end of program line byte, or *:' after the FOR 
statement (ie the address for the NEXT loop to restart at) 


address of line number LB of line containing FOR 


address of byte after NEXT statement (ie the address to 
continue at when the limit is exceeded) 


address of byte after NEXT statement again 


length byte (&16 for Real FORs; &10 for Integer FORs) 


address of line number LB of line containing WHILE 


address of the end of program line byte or *:' after WEND 
statement (ie the address to continue at when the condition 
is false) 


address of condition after the WHILE command 
length byte of &07 - end of WHILE entry proper but: 


value of condition (0 or -1 as a floating point value) only 
while the WHILE entry is the last on the stack 


address of the next space on the GOSUB etc stack (see 
also &AE19) 

NB: The free space on the stack is also used as a 
workspace by various routines for values and addresses 
and for Variable names 


address of end of free space (the byte before the Strings 
area) 


address of end of Strings area (=HIMEM) 
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6128 


&B076 
&B078 


&BO7A 
&B07C 
&BO7E 


&BO9C 
&BO9D 


&BO9F 


&BOAO 


&BOAO 
&BOA2 
&BOA3 
&BOAS 
&B100 
&B102 
&B104 
&B109 
&B10E 
&B113 
&B114 
&B115 
&B116 
&B117 
&B118 
&B118 


&B119 
&B11A 


&B11B 
&B11D 


&B11F 
&B11F 
&B12F 
&B130 


464 
&B092 
&B094 
&B096 


&B098 
&BO9A 
&BO9C 


&BOBA 
&BOBB 
&BOBD 
&BOBF 
&BOC1 


&BOC2 


&BOC2 
&BOC4 
&BOC5 
&BOC7 
&B8E4 
&B8E6 
&B8E8 
&B8ED 
&B8F2 
&B8F7 
&B8DC 
&B8DD 
&B8DE 
&B8DF 
&B800 
&B800 


&B801 
&B802 


&B803 
&B805 


&B807 
&B807 
&B817 
&B818 


Size 


10*3 


Comments on the memory locations 


address of the highest byte of free RAM disregarding 
UDGs (usually &A6FB) 


address for the next entry in the String Concatenation area 


concatenation area holding descriptors of strings being 
used 


length of last String used 


address of last String used 


type byte used with the Virtual Accumulator (&02=Integer; 
&03=String; &05=Real) 


Virtual Accumulator used by the maths routines (two bytes 
for an Integer value; three bytes for a String Descriptor; five 
bytes for a Real value) 


(&39 bytes on 464) bytes of &FF 
&07, &C6 
&65, &89 


DEG/RAD flag (&00=RAD; &FF=DEG) 


Area used for Cassette handling: 


cassette handling messages flag (O=enabled; 
<>O=disabled) 


file IN flag (&00=closed; &02=IN file; &03=opened; &05=IN 
char) 


address of 2K buffer for directories 


address of 2K buffer for loading blocks of files - often as 
&B11B 


IN Channel header 
filename (padded with NULs) 
number of block being loaded, or next to be loaded 


last block flag (&FF=last block; &00=not) 
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6128 
&B131 


&B132 
&B134 


&B136 
&B137 
&B139 


&B13B 
&B15F 


&B160 


&B162 


&B164 
&B164 
&B174 
&B175 
&B176 
&B177 
&B179 


&B17B 
&B17C 
&B17E 


&B180 
&B1A4 
&B1B5 
&B1B7 
&B1B8 
&B1BE 
&B1B9 
&B1BC 
&B1BE 
&B1D5 
&B1E4 
&B1E5 
&B1E6 
&B1E8 
&B1E9 


&B1EA 


464 
&B819 


&B81A 
&B81C 


&B81E 
&B81F 
&B821 


&B823 
&B847 


&B848 


&B84A 


&B84C 
&B84C 
&B85C 
&B85D 
&B85E 
&B85F 
&B861 


&B863 
&B864 
&B866 


&B868 
&B88C 
&B89D 
&B89F 
&B8A3 
&B8A6 
&B51D 
&B520 
&B522 
&B539 
&B8CC 
&B8CD 
&B8CE 
&B8D0 
&B8D1 


&B8D2 


Size 


Comments on the memory locations 


file type (&00=BASIC; &01=Protected BASIC; &02=Binary; 
&08=Screen; &16=ASCIl) 


length of this block 


address to load this or the next block at,or the address of 
the byte after last one loaded 


first block flag (&FF=first block; &00=not) 
total length of file (all blocks) 


execution address for BIN files (&0000 if not saved as 
such) 


not allocated 


file OUT flag (&00=closed; &02=IN file; &03=opened; 
&05=IN char) 


address to start the next block save from, or the address of 
the buffer if it is OPENOUT 


address of start of the last block saved, or the address of 
the buffer if it is OPENOUT 


OUT Channel Header (details as IN Channel Header): 
filename 

number of the block being saved, or next to be saved 
last block flag (&FF=last block; &00=not) 

file type (as at &B131 

length saved so far 


address of start of area to save, or address of buffer if it is 
an OPENOUT instruction 


first block flag (&FF=first block; &00=not) 
total length of file to be saved 


execution address for BIN files (&0000 if parameter not 
supplied) 


not allocated 


used to construct IN Channel header: 


base address for calculating relevant Sound Channel block 
base address for calculating relevant Sound Channel ? 
base address for calculating relevant Sound Channel ? 


base address for calculating relevant Sound Channel ? 


synchronisation byte 


&55, &62 


cassette precompensation (default &06; SPEED WRITE 1 
&0C @4microseconds) 


cassette ‘Half a Zero' duration (default &53; SPEED 
WRITE 1 &29 @ 4microseconds) 
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6128 
&B1EB 


&B1ED 
&B1EE 
&B1F0O 


&B1F8 
&B212 
&B213 
&B217 
&B217 


&B218 


&B219 
&B21B 
&B21C 
&B21D 
&B21F 
&B227 
&B22F 
&B237 
&B256 
&B25E 
&B266 
&B26E 
&B276 
&B295 
&B29D 
&B2A5 
&B2AD 
&B2A6 
&B2B6 
&B2B6 
&B2C6 
&B2D6 
&B2E6 
&B2F6 
&B306 
&B316 
&B326 


464 
&B8D3 
&B550 
&B551 


&B552 
&BB54 
&BB55 
&B55C 
&B576 
&B577 
&B57B 
&B57B 


&B57C 


&B57D 
&B57F 

&B580 

&B581 

&B583 

&B58B 
&B593 

&B59B 
&B5BA 
&B5C2 
&B5CA 
&B5D2 
&B5DA 
&B5F9 
&B601 

&B609 

&B611 

&B60A 
&B61A 
&B61A 
&B62A 
&B63A 
&B64A 
&B65A 
&B66A 
&B67A 
&B68A 


Size 


15*16 
&10 
&10 
&10 
&10 
&10 
&10 
&10 
&10 


Comments on the memory locations 


used by sound routines 

used by sound routines 

used by sound routines 

used by sound routines 

used by sound routines 

used by sound and cassette routines 
Sound Channel A (1) data: 

number of sounds still queuing 

number of sounds originally queuing 

first or fifth sound in Channel 1 (A) queue: 


status: bO to b2 = rendezvous with channel 1, 2 or 4; b3 = 
Hold; b4 = Flush 


b0 to b3 = tone envelope number; b4 to b7 = volume 
envelope number (ie ENV number*16) 


pitch 

noise 

volume 

duration (in 0.01 seconds) 

second sound in Channel 1 queue (as &B217) 
third sound in Channel 1 queue (as &B217) 

fourth sound in Channel 1 queue (as &B217) 
Sound Channel B (2) data - as described at &B1F8 
first or fifth sound in Channel 2 queue (as &B217) 
second sound in Channel 2 queue (as &B217) 
third sound in Channel 2 queue (as &B217) 

fourth sound in Channel 2 queue (as &B217) 
Sound Channel C (4) data - as described at &B1F8 
first or fifth sound in Channel 4 queue (as &B217) 
2nd sound in Channel 4 queue (as &B217) 

3rd sound in Channel 4 queue (as &B217) 

4th sound in Channel 4 queue (as &B217) 

base address for calculating relevant ENV parameter block 
ENV parameter block area (each arranged as &ADA2): 
ENV 1 

ENV 2 

ENV 3 

ENV 4 

ENV 5 

ENV 6 

ENV 7 

ENV 8 
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6128 464 Size Comments on the memory locations 
&B336 &B69A &10 ENV9 
&B346 &B6AA &10 ENV 10 
&B356 &B6BA &10 ENV 11 
&B366 &B6CA &10 ENV 12 
&B376 &B6DA &10 ENV 13 
&B386 &B6EA &10 ENV 14 
&B396 &B6FA &10 ENV 15 
&B396 &B6FA base address for calculating relevant ENT parameter block 
&B3A6 &B70A 15*16 ENT parameter block area (each arranged as &ADA2): 
&B3A6 &B70A &10- ENT 1 
&B3B6 &B71A &10 ENT 2 
&B3C6 = &B72A &10 ENT 3 
&B3D6 &B73A &10 ENT4 
&B3E6 8&B74A &10 ENT5 
&B3F6 &B75A &10 ENT6 
&B406 &B76A &10 ENT7 
&B416 &B77A &10 ENT8 
&B426 &B78A &10 ENT9 
&B436 &B79A &10 ENT 10 
&B446 &B7AA &10 ENT 11 
&B456 &B7BA &10 ENT 12 
&B466 &B7CA &10 ENT 13 
&B476 &B7DA &10 ENT 14 
&B486 &B7EA &10 ENT 15 
&B496 &B34C &50 Normal Key Table: 


(cur U[CurR|CurD[f@ fe 9 _[enter|t. 
Curt (Cony (7 fe (Sm 2 (0 
(cr _ Rete |} | 
fle le fk} tk Ik 
o> le. km ip 


12 (Ee q Taba (Caps 


&B4E6 &B39C &50 Shifted Key Table: 
[Cur U|Cur R [Cur D fo /f6|f3 [Enter /f. 
[CurL [Copy |f7__ fe Sift f2_ fo 
for |fRet_|f [fra 
QF Ih PIF ree 
Lp lo Ie IKJm__ fe 


sj JE wisiple ik 
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&B536 


&B586 


&B590 


&B628 
&B629 
&B62A 
&B62B 
&B62D 
&B62F 
&B630 
&B631 

&B632 
&B633 


&B634 


&B635 


&B635 


&B636 


&B637 


&B638 


&B639 


&B63A 


464 


&B3EC 


&B43C 


&B446 


&B4DE 
&B4DF 
&B4E0 
&B4E1 

&B4E3 
&B4E5 
&B4E6 
&B4E7 
&B4E8 
&B4E9 


&B4EA 


&B4EB 


&B4EB 


&B4EC 


&B4ED 


&B4EE 


&B4EF 


&B4F0O 


Size 


&50 


10 


&98 


1 


1 


Comments on the memory locations 


(iP |lEsclla j-> |[A \[Caps|[z | 
"VAIL (6S) TAB) Fre Fret Dl 


Control Key Table: 

a Cur R |Cur D |f9 6 f3 Enter ||f. 
Cur 

L Copy |f7 8 5 f1 f2 f0 


(cir (Esc) [Ret (Gs) ff4 | Fs) | 
(Rs)[|f(Nuyyfouey[ 
(us) (sl) (HT) (FF) (vt) (cr) | 
[| (NAK) (EM) (BS) (LF) ||(SO) | 

[| (DC2) [(DC4) (BEL) |(ACK) ||(STX) |(SYN) 
ital (ENQ) (ETB) |(DC3) | |(EOT) |(ETX)||(CAN) 
[|r Esc | |(DC1) |Ins/Ovrt |(SOH) |S-Ick ||(SUB) 
[IIL IL det 


KB repeats table (each byte/bit applies to all three key 
tables): 1 byte is used per line of the tables; bO to b7 give 
the columns (left to right), repeat if set 


DEF KEY's definition area (for Keys &80 to &9F in 
sequence): each definition has either a single byte of &00 if 
it is unused/unaltered, or: byte 1: length of definition bytes 
2 to x: definition, either a single key or a string of keys 


Byte after end of DEF KEY area 


address of DEF KEY area 
address of byte after end of DEF KEY area 


Shift lock flag (&00=off; &FF=on) 
Caps lock flag (&00=off; &FF=on) 


KB repeat period (SPEED KEY - default &02 @ 0.02 
seconds) 


KB delay period (SPEED KEY - default &1E @ 0.02 
seconds) 


Tables used for key scanning; bits 0 to 7 give the table 
columns (from left to right): 


[Cur U [Cur R [Cur D |f9|[f6 [3 [Enter |f. 
(Cur L [Copy |f7 [fs [fs [M1 2 |f0 

[Cir [ [Ret] [f4 |Shitt \ [Ctrl 

Mele EEE 

(0/90 fit [mij 

[8 /7 [uly Ih [jn |Space 
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6128 
&B63B 


&B63C 


&B63D 


&B63E 


&B63F 
&B640 
&B641 

&B642 
&B643 
&B644 
&B645 
&B646 
&B647 
&B648 
&B64B 
&B653 
&B654 
&B655 
&B656 
&B657 
&B657 
&B659 
&B65A 
&B65B 
&B65D 
&B65E 


&B67F 
&B686 
&B687 


&B688 
&B689 


&B68A 
&B68B 
&B68D 
&B68F 


464 
&B4F 1 


&B4F2 


&B4F3 


&B4F4 


&B4F5 
&B4F6 
&B4F7 
&B4F8 
&B4F9 
&B4FA 
&B4FB 
&B4FC 
&B4FD 
&B4FE 
&B501 
&B509 
&B50A 
&B50B 
&B50C 
&B50D 
&B50D 
&B50F 
&B510 
&B511 
&B513 
&B514 


&B67F 
&B53C 
&B53D 


&B53E 
&B53F 


&B540 
&B541 
&B543 
&B545 


Size 


1 


1 


1 


NO NO ND 


Comments on the memory locations 


[Down [Up |Left Right |Fire2 |Firet |(Joystick 1) 
[66 frit foto 


[4/3 le [ws idjox 
[1|/2 Esc q [Tab a |Caps|iz 


[Down Up [Left [Right [Fire2 |Firet (Joystick 2) 
LC LILIL_JL_JL__JUbe__] 
complement of &B635 
complement of &B636 
complement of &B637 
complement of &B638 
complement of &B639 
complement of &B63A 
complement of &B63B 
complement of &B63C 
complement of &B63D 
complement of &B63E 


event block for Keyboard handling, comprises: 
chain address 

count 

class: express event 

ROM routine address: &C492 

ROM select number: &FD 


store for last keys pressed and each entry is as follows: 
byte 1: +0 to +10=key tables’ line number; if bit 5 is set 
then Shift is pressed; bit 7=Control is pressed byte 2: bO to 
b7=key tables’ column number - see &B496 etc 


vestige from the 464? 


accumulated count of the number of keys pressed (MOD 
20) 


number of keys left in key buffer 


accumulated count of the number of keys removed from 
the buffer (MOD 20) 


address of the normal key table 
address of the shifted key table 


address of the control key table 
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6128 
&B691 
&B692 
&B693 
&B695 
&B697 
&B699 
&B69B 
&B69D 
&B69F 
&B6A1 
&B6A3 
&B6A4 
&B6A5 


&B6A7 
&B6A9 
&B6AB 
&B6AD 


&B6AF 
&B6BO 
&B6B1 
&B6B2 


&B6B3 
&B6B4 


&B6B5 
&B6B6 


&B6C4 
&B6D2 
&B6E0 
&B6EE 
&B6FC 
&B70A 
&B718 
&B726 
&B726 


&B727 


&B728 


464 
&B547 


&B328 
&B32A 
&B32C 
&B32E 
&B330 
&B332 
&B334 
&B336 
&B338 
&B339 
&B33A 


&B33A 
&B33C 
&B33E 
&B340 
&B342 
&B344 
&B345 
&B346 


&B207 
&B20C 
&B20D 


&B21C 
&B22B 
&B23A 
&B249 
&B258 
&B267 
&B276 
&B285 
&B285 


&B286 


&B287 


Size Comments on the memory locations 


2 address of the KB repeats table 


ORIGIN x 

ORIGIN y 

graphics text x position (pixel) 

graphics text y position(pixel) 

graphics window x of one edge (pixel) 
graphics window x of other edge (pixel) 
graphics window y of one side (pixel) 
graphics window y of other side (pixel) 
1 GRAPHICS PEN 

1 GRAPHICS PAPER 


8/14 (This area is 14 bytes on the 464) Used by line drawing 
(and other) routines, as follows: 


2 x+1() 
2 y/2+1() 
2 y/2-x() 
2 

2 


1 first point on drawn line flag (<>0=to be plotted; O=don't 
plot) 

1 line MASK 

1 

2 

1 current stream number 


14/15 (These areas are 15 bytes on the 464) Stream (window) 0 


parameter block. These areas are arranged as &B726 
14/15 stream (window) 1 parameter block 
14/15 stream (window) 2 parameter block 
14/15 stream (window) 3 parameter block 
14/15 stream (window) 4 parameter block 


14/15 stream (window) 5 parameter block 


~~ ye YSeODCrelUlUWwDrOlUlCUWN 


14/15 stream (window) 6 parameter block 
14/15 stream (window) 7 parameter block 
14/15 Current Stream (Window) parameter block: 


1 cursor y position (line) with respect to the whole screen 
(starting from 0) 


1 cursor x position (column) with respect to the whole screen 
(starting from 0) 
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6128 
&B729 


&B72A 


&B72B 


&B72C 


&B72D 
&B72E 


&B72F 
&B730 
&B731 


&B733 
&B734 


&B735 
&B736 
&B738 
&B758 
&B759 
&B763 


&B763 
&B766 
&B769 
&B76C 
&B/76F 
&B772 


&B775 
&B778 
&B77B 
&B77E 
&B781 

&B784 
&B787 


&B78A 
&B78D 
&B790 


464 
&B288 


&B289 


&B28A 


&B28B 


&B28C 
&B28D 
&B28E 
&B28F 
&B290 
&B291 


&B293 
&B294 


&B295 
&B296 
&B298 
&B2B8 
&B2B9 
&B2C3 


&B2C3 
&B2C6 
&B2C9 
&B2CC 
&B2CF 
&B2D2 


&B2D5 
&B2D8 
&B2DB 
&B2DE 
&B2E1 

&B2E4 
&B2E7 


&B2EA 
&B2ED 
&B2F0O 


Size 


on www wo Ww 


Oo Ww ww wo wo WwW 


Comments on the memory locations 


window top line (y) with respect to the whole screen 
(starting from 0) 


window left column (x) with respect to the whole screen 
(starting from 0) 


window bottom line (y) with respect to the whole screen 
(starting from 0) 


window right colwnn (x) with respect to the whole screen 
(starting from 0) 


scroll count 


cursor flag (&01=disable; &02=off; &FD=on; &FE=enable) 


current PEN number (encoded, not its INK number) 
current PAPER number (encoded, not its INK number) 


address of text background routine: opaque=&1392; 
transparent=&13A0 


graphics character writing flag (O=off; <>O=on) 


ASCII number of the first character in User Defined 
Graphic (UDG) matrix table 


UDG matrix table flag (&00=non-existent; &FF=present) 


address of UDG matrix table 


Control Code handling routine table - each code's entry 
comprises: byte 1: +0 to +9=number of parameters; 
+&80=re-run routine at a System Reset bytes 2 and 3: 
address of the control code's handling routine 


ASC 0: &80,&1513: NUL 

ASC 1: &81,&1335: Print control code chararacter [,char] 
ASC 2: &80,&1297: Disable cursor 

ASC 3: &80,&1286: Enable cursor 

ASC 4: &81,&0AE9: Set mode [,mode] 


ASC 5: &81,&1940: Print character using graphics mode 
[,char] 


ASC 6: &00,&1459: Enable VDU 
ASC 7: &80,&14E1: Beep 

ASC 8: &80,&1519: Back-space 
ASC 9: &80,&151E: Step-right 
ASC 10: &80,&1523: Linefeed 
ASC 11: &80,&1528: Previous line 


ASC 12: &80,&154F: Clear window and locate the cursor 
at position 1,1 


ASC 13: &80,&153F: RETURN 
ASC 14: &81,&12AB: Set paper [,pen] 
ASC 15: &81,&12A6: Set pen [,pen] 
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&B793 


&B796 


&B799 


&B79C 


&B79F 


&B7A2 
&B7A5 
&B7A8 
&B7AB 
&B7AE 


&B7B1 

&B7B4 
&B7B7 
&B7BA 
&B7BD 
&B7CO 


&B7C3 
&B7C4 
&B7C6 
&B7C7 


&B7D2 


&B7D3 


&B7D4 
&B7D4 
&B7D5 
&B7D6 
&B7D7 
&B7D8 
&B7D9 
&B7DA 
&B7DB 
&B7DC 
&B7DD 
&B7DE 
&B/7DF 


464 
&B2F3 


&B2F6 


&B2F9 


&B2FC 


&B2FF 


&B302 
&B305 
&B308 
&B30B 
&B30E 


&B311 

&B314 
&B317 
&B31A 
&B31D 
&B320 


&B1C8 
&B1C9 
&B1CB 
&B1CC 
&B1CF 
&B1D7 


&B1D8 


&B1D9 
&B1D9 
&B1DA 
&B1DB 
&B1DC 
&B1DD 
&B1DE 
&B1DF 
&B1E0 
&B1E1 
&B1E2 
&B1E3 
&B1E4 


Size 


oO ww wo Ww 


oO wwwno wo wo 


Comments on the memory locations 


ASC 16: &80,&155E: Delete the character at the cursor 
position 


ASC 17: &80,&1599: Clear the line up to the current cursor 
position 


ASC 18: &80,&158F: Clear from the cursor position to the 
end of the line 


ASC 19: &80,&1578: Clear from start of the window to the 
cursor position 


ASC 20: &80,&1565: Clear from the cursor position to the 
end of a window 


ASC 21: &80,&1452: Disable VDU 

ASC 22: &81,&14EC: Set text write mode [,mode] 
ASC 23: &81,&0C55: Set graphics draw mode [,mode] 
ASC 24: &80,&12C6: Exchange pen and paper 


ASC 25: &89,&150D: Define user defined character 
[,char,8 rows of char] 


ASC 26: &84,&1501: Define window [,left,right,top, bottom] 
ASC 27: &00,&14EB: ESC (=user) 

ASC 28: &83,&14F 1: Set the pen inks [,pen,ink 1,ink 2] 
ASC 29: &82,&14FA: Set border colours [,ink,ink2] 

ASC 30: &80,&1539: Locate the text cursor at position 1,1 


ASC 31: &82,&1547: Locate the text cursor at 
[,column, line] 


MODE number 

screen offset 

screen base HB (LB taken as &00) 

graphics VDU write mode indirection - JP &0C74 

list of bytes having only one bit set, from b7 down to bO 


first flash period (SPEED INK - default &0A @ 0.02 
seconds) 


second flash period (SPEED INK - default &0A @ 0.02 
seconds) 


Border and Pens' First Inks (as hardware numbers): 
hw &04 = sw 1 (blue) border 

hw &04 = sw 1 (blue) pen 0 

hw &0A = sw 24 (bright yellow) pen 1 
hw &13 = sw 20 (bright cyan) pen 2 
hw &0C = sw 6 (bright red) pen 3 

hw &0B = sw 26 (bright white) pen 4 
hw &14 = sw 0 (black) pen 5 

hw &15 = sw 2 (bright blue) pen 6 

hw &0D = sw 8 (bright magenta) pen 7 
hw &06 = sw 10 (cyan) pen 8 

hw &1E = sw 12 (yellow) pen 9 

hw &1F = sw 14 (pale blue) pen 10 
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26 


6128 
&B7E0 
&B7E1 
&B7E2 
&B7E3 
&B7E4 
&B7E5 
&B7E5 
&B7E6 
&B7E7 
&B7E8 
&B7E9 
&B7EA 
&B7EB 
&B7EC 
&B7ED 
&B7EE 
&B7EF 
&B7FO 
&B7F 1 
&B/7F2 
&B7F3 
&B7F4 
&B7F5 
&B7F6 
&B7F7 
&B7F8 
&B7F9 
&B/7FB 
&B7FD 
&B802 
&B804 


&B805 


&B805 
&B807 
&B809 
&B80B 
&B80D 
&B80F 
&B811 

&B813 


464 
&B1E5 
&B1E6 
&B1E7 
&B1E8 
&B1E9 
&B1EA 
&B1EA 
&B1EB 
&B1EC 
&B1ED 
&B1EE 
&B1FF 
&B1F0O 
&B1F 1 
&B1F2 
&B1F3 
&B1F4 
&B1F5 
&B1F6 
&B1F7 
&B1F8 
&B1F9 
&B1FA 
&B1FB 
&B1FC 
&B1FD 
&BIFE 
&B200 


Size Comments on the memory locations 


1 hw &07 = sw 16 (pink) pen 11 

1 hw &12 = sw 18 (bright green) pen 12 
1 hw &19 = sw 22 (pale green) pen 13 
1 hw &04 = sw 1 (blue) pen 14 

1 hw &17 = sw 11 (sky blue) pen 15 


1+16 Border and Pens' Second Inks (as hardware numbers): 


1 hw &04 = sw 1 (blue) border 

1 hw &04 = sw 1 (blue) pen 0 

1 hw &0A = sw 24 (bright yellow) pen 1 
1 hw &13 = sw 20 (bright cyan) pen 2 

1 hw &0C = sw 6 (bright red) pen 3 

1 hw &0B = sw 26 (bright white) pen 4 

1 hw &14 = sw 0 (black) pen 5 

1 hw &15 = sw 2 (bright blue) pen 6 

1 hw &0D = sw 8 (bright magenta) pen 7 
1 hw &06 = sw 10 (cyan) pen 8 

1 hw &1E = sw 12 (yellow) pen 9 

1 hw &1F = sw 14 (pale blue) pen 10 

1 hw &07 = sw 16 (pink) pen 11 

1 hw &12 = sw 18 (bright green) pen 12 
1 hw &19 = sw 22 (pale green) pen 13 
1 hw &04 = sw 1 (bright yellow) pen 14 
1 hw &17 = sw 11 (pink) pen 15 

1 

1 

1 

2 

2 

1+1 

1 eee of entries in the Printer Translation Table (normally 


20*2 Printer Translation Table; each entry comprises: byte 1: 
screen code byte 2: pnnter code 


screen &A0 printer &5E (acute accent) 
screen &A1 printer &5C (\) 

screen &A2 printer &7B ({) 

screen &A3 printer &23 (#) 

screen &A6 printer &40 (@) 

screen &AB printer &7C (|) 

screen &AC printer &7D (}) 

screen &AD printer &7E (~) 


MO MO NY NB NB YB NM ND 
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6128 
&B815 
&B817 
&B819 
&B82D 
&B82E 
&B82F 
&B831 
&B832 


&B834 


&B8B4 


&B8B8 
&B8B9 
&B8BB 
&B8BD 
&B8BF 


&B8C0 
&B8C2 
&B8C3 


&B8D3 
&B8D5 
&B8D6 
&B8D7 


&B8D9 
&B8DA 


&B8DA 
&B8DC 
&B8DE 
&B8E0 
&B8E2 
&B8E4 
&B8E6 
&B8E8 
&B8EA 
&B8EC 
&B8EE 
&B8FO 


464 


&B100 
&B101 
&B102 
&B104 
&B105 


&B107 


&B187 


&B18B 
&B18C 
&B18E 
&B190 
&B192 


&B193 
&B195 
&B196 


&B1A6 


&B1A8 
&B1A9 


&B1AB 


&B1AC 


&B1AC 
&B1AE 
&B1B0 
&B1B2 
&B1B4 
&B1B6 
&B1B8 


T*2 


NM MO DMO NHB YB NYO YB YB YP NY NM ND 


Comments on the memory locations 
screen &AE printer &5D (]) 
screen &AF printer &SE ([) 


room for ten more translations 


temporary store for stack pointer (SP) during interrupt 
handling 


temporary machine stack (from &B8B3 downwards) during 
interrupt handling 


TIME (stored with the LB first - four bytes give >166 days; 
three bytes give >15 hours) 


address of the first ticker block in chain (if any) 


Keyboard scan flag (&00=scan not needed; &01=scan 
needed) 


address of the first event block in chain (if any) 


buffer for last RSX or RSX command name (last character 
has bit 7 set) 


address of first ROM or RSX chaining block in chain 
RAM bank number 
Upper ROM status (eg select number) 


entry point of foreground ROM in use (eg &C006 for BASIC 
ROM) 


foreground ROM select address (0 for the BASIC ROM) 


ROM entry IY value (ie the address table) - the 6128 has 
ROMs numbered from 0 to 15: 


ROM entry IY value (ie the address table) 
ROM 0 IY (not for the 464) 

ROM 1 lY 

ROM 2 lY 

ROM 3 IY 

ROM 4 lY 

ROM 5 IY 

ROM 6 IY 

ROM 7 IY (usually &A700 for AMSDOS/CPM ROM) 
ROM 81VY (not 464) 

ROM 9 IY (not 464) 

ROM 10 1Y (not 464) 

ROM 171 IY (not 464) 
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6128 
&B8F2 
&B8F4 
&B8F6 
&B8F8 
&B8FA 


&B900 


&B924 


&BAE4 
&BBOO 
&BB4E 
&BBBA 
&BBFF 
&BC65 
&BCA7 
&BCC8 
&BD13 


&BD61 


&BDCD 


&BDF7 


&BE0O 
&BE40 


&BE40 
&BE42 
&BE44 
&BE44 
&BE46 
&BE48 
&BE49 
&BE4A 
&BE4B 
&BE4C 


&BE4D 
&BE4F 
&BE4F 
&BE50 
&BE51 


464 


&B1BA 
&B900 


&B921 


&BAEQ 
&BBOO 
&BB4E 
&BBBA 
&BBFF 
&BC65 
&BCA7 
&BCC8 
&BD13 


&BD3D 


&BDCD 


&BDF4 


&BEOO 
&BE40 


&BE40 
&BE42 
&BE44 
&BE44 
&BE46 
&BE48 
&BE49 
&BE4A 
&BE4B 
&BE4C 


&BE4D 
&BE4F 
&BE4F 
&BE50 
&BE51 


Size 


Comments on the memory locations 
ROM 12 IY (not 464 
ROM 13 IY (not 464 
ROM 14 IY (not 464 
ROM 15 IY (not 464 
6 bytes of &FF 
14 bytes of &00 


High Kernel Jumpblock (on the 464 this block is 11*3 bytes 
in size) 


) 
) 
) 
) 


routines used by the High Kernel Jumpblock (on the 464 
this is &1C8 bytes in size) 


bytes of &FF (&1C bytes on 6128, &17 bytes on 464) 
Key Manager Jumpblock 

Text VDU Jumpblock 

Graphics VDU Jumpblock 

Screen Pack Jumpblock 

Cassette (and Disc if fitted) Manager Jumpblock 
Sound Manager Jumpblock 

Kernel Jumpblock 


Machine Pack Jumpblock (on the 464 this block is 14*3 
bytes in size) 


Maths Jumpblock (on the 464 this block is 48*3 bytes in 
size) 


Firmware Indirections (on the 464 this block is 13*3 bytes 
in size 


bytes of &00 (&09 bytes on 6128, &0C bytes on the 464) 
the lower limit of Machine Stack if no Disc Drive 


&40 bytes of &FF 


used by the AMSDOS ROM if a disc drive is fitted 
(otherwise &4x bytes of &FF) 


(address &A910) 

address of drive A XDPB 

Disc Set Up timing block: 

motor on period (default &0032; fastest &0023 @ 20mS) 
motor off period (default &00FA; fastest &300C8 @ 20mS) 
write current off period (default &AF @ 10zeS) 

head settle time (default &80F @ 1mS) 

step rate period (default &0C; fastest &0A @ 1mS) 

head unload delay (default &01) 


b0=non DMA mode; b1 to b7=head load delay (default 
&03) 


Drive Header Information Block: 
last track used 
head number (&00) 


last sector used 
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6128 
&BE52 
&BE53 
&BE54 
&BE55 
&BE56 
&BE58 
&BE59 
&BE5D 
&BE5E 
&BE5SF 
&BE60 
&BE62 
&BE64 
&BE66 
&BE67 
&BE67 
&BE69 
&BE6B 
&BE6D 
&BE6F 
&BE70 
&BE71 
&BE73 
&BE74 
&BE75 
&BE76 


&BE78 


&BE7D 
&BE/7F 


&BE80 
&BFOO 
&BFxy 


&BFFF 


464 
&BE52 
&BE53 
&BE54 
&BE55 
&BE56 
&BE58 
&BE59 
&BE5D 
&BES5E 
&BE5SF 
&BE60 
&BE62 
&BE64 
&BE66 
&BE67 
&BE67 
&BE69 
&BE6B 
&BE6D 
&BE6F 
&BE70 
&BE71 
&BE73 
&BE74 
&BE75 
&BE76 


&BE78 


&BE7D 
&BE/7F 


&BE80 
&BFOO 


&BFFF 


Size 


1 


&80 


Comments on the memory locations 


log2(sector size)-7 


disc motor flag (&00=off;&01=on - strangely reversed) 
address of buffer for directory entries block (&A930) 
as &BE76 (ie&A9BO) 


disc retries (default &10) 

AMSDOS Ticker and Event Block: 

ticker chaining address 

tick count 

recharge count 

event chaining address 

count 

class (asynchronous event) 

ROM routine address (&C9D6) 

ROM select number (&07 ie the AMSDOS/CPM ROM) 


last sector number used 


address of «K buffer, or of header info block (for WRITE 
SECTOR etc) 


disc error message flag (&00=on; &FF=off - reversed 
again) 


address of AMSDOS reserved area (&A700) 


area used by AMSDOS to copy routines into RAM for 
running 


&80 bytes of &FF (limit of machine stack if disc drive fitted) 
&xy bytes of &00) 


machine stack (in theory this stack could extend down 
much further) 


upper limit of machine stack 
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The area from &C000 to &FFFF is taken up by the screen memory - the layout of which is illustrated 
below. Printed below are diagrams which show how the CPC uses the bytes of screen memory in the 
different MODEs. For each byte: 


in MODE 2 (where there are two colours only, each pixel needs only one bit - either on or off) 
bit7 bit6 bit5 bit4 bit3 bit2 bit1 bitO 

pO plt p2 p3 p4 pS pb pr/ 

(the pixels are arranged with pO being the leftmost one, etc) 


in MODE 1 (where four colours are available and so two bits are needed for each pixel - 1 
byte represents 4 pixels) 


bit7 bit6 bitS bit4 bit3 bit2 bit1 bit0 
p0(1) p1(1) p2(1) p3(1) pO(O) p1(0) p2(0) p3(0) 
(each pixel is twice as wide as in MODE 2) 


in MODE 0 (where sixteen colours are possible and four bits are needed for each pixel - 1 
byte represents 2 pixels) 


bit? bit6 bit5 bit4 bit3 bit2 biti bitd 
pO(0) p1(0) pO(2) p1(2) pO(1) p1(1) p0(3) p1(3) 


(each pixel is four times as wide as in MODE 2) 


NB: The numbers in brackets show which bit of the pixel's pen number the screen byte bit refers to. 
For example in MODE 1, the 4 most significant bits of the byte hold bit 1 of the pixel's pen value and 
the least signifcant bits hold bit 0 of the pen value. 
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LINE ROWO ROW1 ROW2 ROW3 ROW4 ROWS ROWG6 ROW7 
cooo C800 D000 D800 E000 E800 F000 F800 
C050 C850 D050 D850 E050 E850 F050 F850 
COAO C8A0 DOAO D8AO EOAO E8A0 FOAO F8A0 
COFO C8FO DOFO D8FO EOFO E8FO FOFO F8FO 
C140 C940 D140 D940 E140 E940 F140 F940 
C190 C990 D190 D990 E190 E990 F190 F990 
C1E0 C9EO D1E0 D9EO E1E0 E9SEO F1E0 F9EO 
C230 CA30 D230 DA30 E230 EA30 F230 FA30 
C280 CA80 D280 DA80 E280 EA80 F280 FA80 
10 C2D0 CADO D2D0 DADO E2D0 EADO F2D0 FADO 
11 C320 CB20 D320 DB20 E320 EB20 F320 FB20 
12 C370 CB70 D370 DB70 E370 EB70 F370 FB70 
13 C3C0 CBCO D3C0O DBCO E3C0 EBCO F3C0 FBCO 
14 C410 CC10 D410 DC10 E410 EC10 F410 FC10 
15 C460 CC60 D460 DC60 E460 EC60 F460 FC60 


—_ 


o ONO aA FF WO NY 
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16 
17 
18 
19 
20 
21 
22 
23 
24 
25 


C4B0 
C500 
C550 
C5A0 
CSFO 
C640 
C690 
C6E0 
C730 
C780 


spare start C7DO 
spareend C/FF 


Once the whole screen has been scrolled in any direction, the table will become incorrect. On 
scrolling, all the above addresses will have an offset (MOD &800) added, derived as follows: 


CCBO 
CD00 
CD50 
CDAO 
CDFO 
CE40 
CE90 
CEEO 
CF30 
CF80 
CFDO 
CFFF 


D4B0O 
D500 
D550 
D5A0 
D5FO 
D640 
D690 
D6E0 
D730 
D780 
D7D0O 
D7FF 


DCBO 
DDOO 
DD50 
DDAO 
DDFO 
DE40 
DE90 
DEEO 
DF30 
DF80 
DFDO 
DFFF 


E4B0 
E500 
E550 
ES5A0 
ESFO 
E640 
E690 
E6E0 
E730 
E780 
E7D0 
E7FF 


ECBO 
EDOO 
ED50 
EDAO 
ED50 
EE40 
EE90 
EEEO 
EF30 
EF80 
EFDO 
EFFF 


F4B0 
F500 
F550 
FSA0 
F550 
F640 
F690 
F6EO 
F730 
F780 
F7D0O 
F7FF 


FCBO 
FDOO 
FD50 
FDAO 
FD50 
FE40 
FE9O 
FEEO 
FF30 
FF80 
FFDO 
FFFF 


e +802 per scroll to the left (2, 1 or % character in MODE 2, MODE 1 or MODE 0 respectively) 


e -&02 per scroll to the right (2, 1 or % character in MODE 2, MODE 1 or MODE 0 respectively) 


e +850 per scroll up one line 


e -&50 per scroll down one line 


If scrolled far enough, a screen row may sit across the boundaries of the screen memory area, whose 

bottom end will then wrap around to join up with the top (ie byte &FFFF will be followed by byte &CO00 
assuming the normal screen area). If before scrolling however, a window had been set up smaller than 
the whole screen then the table will remain accurate despite any scrolling. The ‘spare’ areas of screen 


memory are filled with bytes of the relevant PAPER value each time there is a full screen CLS, and 
are not really available for other uses. After scrolling the spare areas may be used as screen with 


other bytes becoming spare. 
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The Firmware Guide — Summary 


The Firmware Jumpblock is the recommended method of communicating with the routines in the lower 
ROM - it is used by BASIC, and it should also be used by other programs. The reason for using the 
jumpblock is that the routines in the lower ROM are located at different positions on the different 
machines. The entries in the jumpblock, however, are all in the same place - the instructions in the 
jumpblock redirect the computer to the correct place in the lower ROM. Thus, providing a program 
uses the jumpblock, it should work on any CPC computer. By altering the firmware jumpblock it is 
possible to make the computer run a different routine from normal. This could either be a different 
routine in the lower or upper ROM, or a routine written by the user - this is known as ‘patching the 
jumpblock'. It is worth noting that because BASIC uses the firmware jumpblock quite heavily, it is 
possible to alter the effect of BASIC commands. The following example will change the effect of calling 
SCR SET MODE (&BCOE) - instead of changing the mode, any calls to this location will print the letter 
‘A’. The first thing to do is to assemble the piece of code that will be used to print the letter - this is 
printed below and starts at &4000. 


ORG &4000 

LDA,65 ;65is ASCII FOR'A' 
CALL &BB5A_ ; TXT OUTPUT 
RET ; return from subroutine 


The jumpblock entry for SCR SET MODE is now patched so that it reroutes all calls to 8BCOE away 
from the lower ROM and to our custom routine at &4000. This is done by changing the bytes at 
&BCOE, &BCOF and &BC10 to &C3, &00, &40 respectively (ie JP &4000). Any calls to &BCOE or 
MODE commands will now print the letter A instead of changing mode. The indirections jumpblock 
contains a small number of routines which are called by the rest of the firmware. By altering this 
jumpblock, it is possible to alter the way in which the firmware operates on a large scale - thus it is not 
always necessary to patch large numbers of entries in the firmware jumpblock. There are two 
jumpblocks which are to do with the Kemel (ie the high and low Kernel jumpblocks). The high 
jumpblock allows ROM states and interrupts to be altered, and also controls the introduction of RSXs. 
The low jumpblock contains general routines and restart instructions which are used by the computer 
for its own purposes. 
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The Kernel 


&BCC8 
Action 


Entry 


Exit 


&BCCB 
Action 


Entry 


Exit 


Notes 


&BCCE 


Action 


Entry 


Exit 


Notes 


&BCD1 


Action 
Entry 


Exit 
&BCD4 
Action 


Entry 


Exit 


Notes 


&BCD7 


Action 
Entry 


Exit 
&BCDA 


Action 


Entry 


KL CHOKE OFF 
Clears all event queues and timer lists, with the exception of keyboard scanning and sound routines 
No entry conditions 


B contains the foreground ROM select address (if any), DE contains the ROM entry address, C holds 
the ROM select address for a RAM foreground program, AF and HL are corrupt, and all others are 
preserved 


KL ROM WALK 
Finds and initialises all background ROMs 
DE holds the address of the first usable byte of memory, HL holds the address of the last usable byte 


DE holds the address of the new first usable byte of memory, HL holds the address of the new last 
usable byte, AF and BC are corrupt, and all other registers are preserved 


This routine looks at the ROM select addresses from 0 to I5 (1 to 7 for the 464) and calls the 
initialisation routine of any ROMs present; these routines may reserve memory by adjusting DE and HL 
before returning control to KL ROM WALK, and the ROM is then added to the list of command handling 
routines 


KL INIT BACK 
Finds and initialises a specific background ROM 


C contains the ROM select address of the ROM, DE holds the address of the first usable byte of 
memory, HL holds the address of the last usable byte of memory 


DE holds the address of the new first usaUe byte of memory, HL holds the address of the new last 
usable byte. AF and B are corrupt, and all other registers are preserved 


The ROM select address must be in the range of 0 to 15 (or 1 to 7 for the 464) although address 7 is tor 
the AMSDOS/CPM ROM if present. The ROM's initialisation routine is then called and some memory 
may be reserved for the ROM by adjusting the values of DE and HL before returning control to KL INIT 
BACK 


KL LOG EXT 
Logs on a new RSX to the firmware 


BC contains the address of the RSX's command table, HL contains the address of four bytes 
exclusively for use by the firmware 


DE is corrupt, and all other registers are preserved 

KL FIND COMMAND 

Searches an RSX, background ROM or foreground ROM, to find a command in its table 
HL contains the address of the command name (in RAM only) which is being searched for 


If the narne was found in a RSX or background ROM then Carry is true, C contains the ROM select 
address, and HL contains the address of the routine; if the command was not found, then Carry is false, 
C and HL are corrupt; in either case, A, B and DE are corrupt, and all others are preserved 


The command names should be in upper case and the last character should have &80 added to it; the 
sequence of searching is RSXs, then ROMs with lower numbers before ROMs with higher numbers 


KL NEW FRAME FLY 
Sets up a frame flyback event block which will be acted on whenever a frame flyback occurs 


HL contains the address of the event block in the central 32K of RAM, B contains the event class. C 
contains the ROM select address (if any), and DE contains the address if the event routine 


AF, DE and HL are corrupt, and all other registers are preserved 
KL ADD FRAME FLY 


Adds an existing but deleted frame flyback event block to the list of routines run when a frame flyback 
occurs 


HL contains the address of the event block (in the central 32K of RAM) 
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Exit 
&BCDD 


Action 


Entry 
Exit 
&BCEO 


Action 
Entry 


Exit 
&BCE3 


Action 


Entry 
Exit 
&BCE6 


Action 


Entry 
Exit 
&BCE9 


Action 
Entry 


Exit 


Notes 


&BCEC 
Action 
Entry 
Exit 


&BCEF 


Action 
Entry 


Exit 


Notes 
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AF, DE and HL are corrupt, and all others are preserved 
KL DEL FRAME FLY 


Removes a frame flyback event block from the list of routines which are mn when a frame flyback 
occurs 


HL contains the address of the event block 

AF, DE and HL are corrupt, and all others are preserved 

KL NEW FAST TICKER 

Sets up a fast ticker event block which will be run whenever the I/300th second ticker interrupt occurs 


HL contains the address of the event block (in the central 32K of RAM), B contains the event class, C 
contains the ROM select address (if any), and DE contains the address of the event routine 


AF, DE and HL are corrupt, and all other registers are preserved 
KL ADD FAST TICKER 


Adds an existing but deleted fast ticker event block to the list of routines which are run when the I/300th 
sec ticker interrupt occurs 


HL contains the address of the event block 
AF, DE and HL are corrupt, and all the other registers are preserved 
KL DEL FAST TICKER 


Removes a fast ticker event block from the list of routines run when the I/300th sec ticker interrupt 
occurs 


HL contains the address of the event block 

AF, DE and HL are corrupt, and all others are preserved 

KL ADD TICKER 

Sets up a ticker event block which will be run whenever a 1/50th second ticker interrupt occurs 


HL contains the address of the event block (in the central 32K of RAM), DE contains the initial value for 
the counter, and BC holds the value that the counter will be given whenever it reaches zero 


AF, BC, DE and HL are corrupt, and all the other registers are preserved 


Every 1/50th of a second all the tick blocks are looked at and their counter is decreased by 1; when the 
counter reaches zero, the event is “kicked' and the counter is loaded with the value in BC; any tick block 
with a counter of 0 is ignored, and therefore if the value in BC is 0, the event will be kicked only once 
and ignored after that 


KL DEL TICKER 


Removes a ticker event block from the list of routines that are run when a I/50th sec ticker interrupt 
occurs 


HL contains the address of the event block 


If the event block was found, then Carry is true, and DE holds the value remaining of the counter; if the 
event block was not found, then Carry is false, and DE is corrupt; in both cases, A, HL and the other 
flags are corrupt, and all other registers are preserved 


KL INIT EVENT 
Initialises an event block 


HL contains the address of the event block (in the central 32K of RAM), B contains the class of event, 
and C contains the ROM select address, and DE holds the address of the event routine 


HL holds the address of the event block+7, and all other registers are preserved 


The event class is derived as follows 

bit 0 -indicates a near address 

bits 1 to 4 - hold the synchronous event priority 

bit 5 - always zero 

bit 6 - if bit 6 is set, then it is an express event 

bit 7 - if bit 7 is set, then it is an asynchronous event. 

Asynchronous events do not have priorities; if it is an express asynchronous event, then its event 
routine is called from the interrupt path; if it is a normal asynchronous event, then its event routine is 
called just before returning from the interrupt; if it is an express synchronous event, then it has a higher 
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&BCF2 
Action 
Ently 
Exit 
&BCF5 
Action 
Entry 
Exit 
Notes 
&BCF8 
Action 
Entry 
Exit 
&BCFB 
Action 


Entry 


Exit 


&BCFE 
Action 
Entry 
Exit 
Notes 
&BD01 
Action 
Entry 
Exit 


Notes 


&BD04 
Action 
Entry 
Exit 
&BD07 
Action 
Entry 
Exit 
&BDOA 


Action 


priority than normal synchronous events, and it may not be disabled through use of KL EVENT 
DISABLE; if the near address bit is set, then the routine is located in the central 32K of RAM and is 
called directly, so saving time; no event may have a priority of zero 


KL EVENT 

Kicks an event block 

HL contains the address of the event block 

AF, BC, DE and HL are corrupt, and all other registers are preserved 
KL SYNC RESET 

Clears the synchronous event queue 

No entry conditions 

AF and HL are corrupt, and all other registers are preserved 

When using this routine, all events that are waiting to be dealt with are simply discarded 
KL DEL SYNCHRONOUS 

Removes a synchronous event from the event queue 

HL contains the address of the event block 

AF, BC, DE and HL are corrupt, and all other registers are preserved 
KL NEXT SYNC 

Finds out if there is a synchronous event with a higher priority 

No entry conditions 


If there is an event to be processed, then Carry is true, HL contains the address of the event block, and 
A contains the priority of the previous event; if there is no event to be processed, then Carry is false, 
and A and HL are corrupt; in either case, DE is corrupt, and all other registers are preserved 


KL DO SYNC 

Runs a synchronous event routine 

HL contains the address of the event block 

AF, BC, DE and HL are corrupt, and all other registers are preserved 

See KL DONE SYNC below 

KL DONE SYNC 

Finishes running a synchronous event routine 

A contains the priority of the previous event, and HL contains the address of the event block 
AF, BC, DE and HL are corrupt, and all other registers are preserved 


When an event that is waiting to be processed has been found by KL NEXT SYNC, the event routine 
should be run by KL DO SYNC; after this KL DONE SYNC should be called so that the event counter 
can be decreased - if the counter is greater than zero then the event is placed back on the synchronous 
event queue 


KL EVENT DISABLE 

Disables norrnal synchronous events 

No entry conditions 

HL is corrupt, and all other registers are preserved 
KL EVENT ENABLE 

Enables normal synchronous events 

No entry conditions 

HL is corrupt, and all other registers are preserved 
KL DISARM EVENT 


Disarrns a specific event and stops it from occurring 
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Entry 
Exit 
Notes 
&BDOD 


Action 
Entry 
Exit 
Notes 


&BD10 
Action 
Entry 
Exit 


HL contains the address of the event block 

AF is corrupt, and all other registers are preserved 

This routine should be used to disarm only asynchronous events; see also KL DEL SYNCHRONOUS 
KL TIME PLEASE 


Returns the time that has elapsed since the computer was switched on or reset (in 1/300ths of a 
second) 


No entry conditions 
DEHL contains the four byte count of the time elapsed, and all other registers are preserved 


D holds the most signifilcant byte of the time elapsed, and L holds the least significant; the four byte 
count overflows after approximately I66 days have elapsed. 


KL TIME SET 
Sets the elapsed time (in Ij300ths of a second) 
DEHL contains the four byte count of the time to set 


AF is corrupt, and all other registers are preserved 


Low Kernel Jumpblock 


&0000 
Action 
Entry 
Exit 
Notes 
&0008 
Action 
Entry 
Exit 


Notes 


&000B 
Action 
Entry 
Exit 


Notes 


&000E 
Action 
Entry 
Exit 
&0010 
Action 


Entry 
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RESET ENTRY (RST 0) 

Resets the computer as if it has just been switched on 

No entry conditions 

This routine is never returned from 

After initialisation of the hardware and firmware, control is handed over to ROM 0 (usually BASIC) 
LOW JUMP (RST 1) 

Jumps to a routine in either the lower ROM or low RAM 

No entry conditions - all the registers are passed to the destination routine unchanged 

The registers are as set by the routine in the lower ROM or RAM or are returned unaltered 


The RST 1 instruction is followed by a two byte low address, which is defmed as follows 

if bit 15 is set, then the upper ROM is disabled 

if bit 14 is set, then the lower ROM is disabled 

bits 13 to 0 contain the address of the routine to jump to. This command is used by the majority of entries 
in the main firmware jumpblock 


KL LOW PCHL 

Jumps to a routine in either the lower ROM or low RAM 

HL contains the low address - all the registers are passed to the destination routine unchanged 
The registers are as set by the routine in the lower ROM or RAM or are returned unaltered 


The two byte low address in the HL register pair is defined as follows 
if bit 15 is set, then the upper ROM is disabled 

if bit 14 is set, then the lower ROM is disabled 

bits 13 to 0 contain the address of the routine to jump to 


PCBC INSTRUCTION 

Jumps to the specified address 

BC contains the address to jump to - all the registers are passed to the destination routine unaltered 
The registers are as set by the destination routine or are returned unchanged 

SIDE CALL (RST 2) 

Calls a routine in ROM, in a group of up to four foreground ROMs 


No entry conditions - all the registers apart from IY are passed to the destination routine unaltered 
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Exit 


Notes 


&0013 


Action 
Entry 


Exit 


Notes 


&0016 
Action 
Entry 
Exit 
&0018 
Action 
Entry 
Exit 


Notes 


&001B 


Action 
Entry 


Exit 
Notes 
&001E 
Action 
Entry 
Exit 
&0020 
Action 
Entry 
Exit 
Notes 
&0023 


Action 


IY is corrupt, and the other registers are as set by the destination routine or are returned unchanged 


The RST 2 instruction is followed by a two byte side address, which is defined as follows 

bits 14 and 15 give a number between 0 and 3, which is added to the main foreground ROM select 
address - this is then used as the ROM select address bits 0 to 13 contain the address to which is added 
&C000 - this gives the address of the routine to be called 


KL SIDE PCHL 
Calls a routine in another ROM 


HL contains the side address - all the registers apart from IY are passed to the destination routine 
unaltered 


IY is corrupt, and the other registers are as set by the destination routine or are returned unchanged 


The two byte side address is defined as follows 

bits 14 and 15 give a number between 0 and 3, which is added to the main foreground ROM select 
address - this is then used as the ROM select address bits 0 to 13 contain the address to which is added 
&C000 - this gives the address of the routine to be called 


PCDE INSTRUCTION 

Jumps to the specified address 

DE contains the address to jump to - all the registers are passed to the destination routine unaltered 
The registers are as set by the destination routine or are returned unchanged 

FAR CALL (RST 3) 

Calls a routine anywhere in ROM or ROM 

No entry conditions - all the registers apart from IY are passed to the destination routine unaltered 

IY is preserved, and the other registers are as set by the destination routine or are returned unchanged 


The RST 3 instruction is followed by a two byte in-line address. At this address, there is a three byte far 
address, which is defined as follows 

bytes 0 and 1 give the address of the routine to be called 

byte 2 is the ROM select byte which has values as follows 

&00 to &FB-- select the given upper ROM, enable the upper ROM and disable the lower ROM 

&FC - no change to the ROM selection, enable the upper and lower ROMs 

&FD - no change to the ROM selection, enable the upper ROM and disable the lower ROM 

&FE - no change to the ROM selection, disable the upper ROM and enable the lower ROM 

&FF - no change to the ROM selection, disable the upper and lower ROMs 

When it is retumed from, the ROM selection and state are restored to their settings before the RST 3 
command 


KL FAR PCHL 
Calls a routine, given by the far address in HL & C, anywhere in RAM or ROM 


HL holds the address of the routine to be called, and C holds the ROM select byte - all the registers apart 
from IY are passed to the destination routine unaltered 


IY is preserved, and the other registers are as set by the destination routine or are returned unchanged 
See FAR CALL (RST 3) above for more details on the ROM select byte 

PCHL INSTRUCTION 

Jumps to the specified address 

HL contains the address to jump to - all the registers are passed to the destination routine unaltered 
The registers are as set by the destination routine or are returned unchanged 

RAM LAM 

Puts the contents of a RAM memory location into the A register 

HL contains the address of the memory location 

A holds the contents of the memory location, and all other registers are preserved 

This routine always reads from RAM, even if the upper or lower ROM is enabled 

KL FAR CALL 

Calls a routine anywhere in RAM or ROM 
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Entry 


Exit 
Notes 
&0028 
Action 
Entry 
Exit 


Notes 


&0030 
Action 
Entry 
Exit 
Notes 
&0038 
Action 
Entry 
Exit 


Notes 


&003B 
Action 
Entry 
Exit 


Notes 


HL holds the address of the three byte far address that is to be used - all the registers apart from IY are 
passed to the destination routine unaltered 


IY is preserved, and the other registers are as set by the destination routine or are returned unchanged 
See FAR CALL above for more details on the three byte far address 

FIRM JUMP (RST 5) 

Jumps to a routine in either the lower ROM or the central 32K of RAM 

No entry conditions - all the registers are passed to the destination routine unchanged 

The registers are as set by the routine in the lower ROM or RAM or are returned unaltered 


The RST 5 instruction is followed by a two byte address, which is the address to jump to; before the jump 
is made, the lower ROM is enabled, and is disabled when the destination routine is returned from 


USER RESTART (RST 6) 

This is an RST instruction that may be set aside by the user for any purpose 

Defined by the user 

Defined by the user 

The bytes from &0030 to &0037 are available for the user to put their own code in if they wish 
INTERRUPT ENTRY (RST 7) 

Deals with normal interrupts 

No entry conditions 

All registers are preserved 


The RST 7 instruction must not be used by the user; any external interrupts that are generated by 
hardware on the expansion port will be dealt with by the EXT INTERRUPT routine (see Low Kernel 
Jumpblock) 


EXT INTERRUPT 

This area is set aside for dealing with external interrupts that are generated by any extra hardware 
No entry conditions 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


If any external hardware is going to generate interrupts, then the user must patch the area from &003B to 
&003F so that the computer can deal with the external interrupt; when an external interrupt occurs, the 
lower ROM is disabled and the code at &003B is called; the default external interrupt routine at &003B 
simply returns, and this will cause the computer to hang because the interrupt will continue to exist 


High Kernel Jumpblock 


&B900 
Action 
Entry 
Exit 


Notes 


&B903 
Action 
Entry 
Exit 


Notes 
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KL U ROM ENABLE 

Enables the current upper ROM 

No entry conditions 

A contains the previous state of the ROM, the flags are corrupt, and all other registers are preserved 


After this routine has been called, all reading from addresses between &C000 and &FFFF refers to the 
upper ROM, and not the top 16K of RAM which is usually the screen memory; any writing to these 
addresses still affects the RAM as, by its nature, ROM cannot be written to 


KL U ROM DISABLE 

Disables the upper ROM 

No entry conditions 

A contains the previous state of the ROM, the flags are corrupt, and all other registers are preserved 


After this routine has been called, all reading from addresses between &C000 and &FFFF refers to the 
top 16K of RAM which is usually the screen memory 
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&B906 KL L ROM ENABLE 

Action Enables the lower ROM 

Entry No entry conditions 

Exit A contains the previous state of the ROM, the flags are corrupt, and all other registers are preserved 


After this routine has been called, all reading from addresses between &0000 and &4000 refers to the 
lower ROM, and not the bottom 16K of RAM; any writing to these addresses still affects the RAM as a 
ROM cannot be written to; the lower ROM is automatically enabled when a firmware routine is called, 
and is then disabled when the routine returns 


&B909 KLL ROM DISABLE 
Action Disables the lower ROM 


Notes 


Entry No entry conditions 
Exit A contains the previous state of the ROM, the flags are corrupt, and all other registers are preserved 


After this routine has been called, all reading from addresses between &0000 and &4000 refers to the 
Notes bottom 16K of RAM; the lower ROM is automatically enabled when a firmware routine is called, and is 
then disabled when the routine returns 


&B90C KL ROM RESTORE 

Action Restores the ROM to its previous state 

Entry Acontains the previous state of the ROM 

Exit AF is corrupt, and all other registers are preserved 


The previous four routines all return values in the A register which are suitable for use by KL ROM 
RESTORE 


&B90F KL ROM SELECT 


Notes 


Action Selects an upper ROM and also enables it 

Entry Ccontains the ROM select address of the required ROM 

Exit C contains the ROM select address of the previous ROM, and B contains the state of the previous ROM 
&B912 KL CURR SELECTION 

Action Gets the ROM select address of the current ROM 

Entry No entry conditions 

Exit A contains the ROM select address of the current ROM, and all other registers are preserved 

&B915 KL PROBE ROM 

Action Gets the class and version of a specified ROM 

Entry | Ccontains the ROM select address of the required ROM 


A contains the class of the ROM, H holds the version number, L holds me mark number, B and the flags 


am are corrupt, and all other registers are preserved 


The ROM class may be one of the following: 
&00 - a foregroumd ROM 
Notes &01 - a background ROM 
&02 - an extension foreground ROM 
&80 - the built in ROM (ie the BASIC ROM) 


&B918 KL ROM DESELECT 
Action Selects the previous upper ROM and sets its state 


C contains me ROM select address of the ROM to be reselected, and B contains the state of the 
required ROM 


Entry 
Exit C contains the ROM select address of me current ROM, B is corrupt, and all others are preserved 
Notes This routine reverses the acoon of KL ROM SELECT, and uses the values that it returns in B and C 
&B91B KLLDIR 


Action Switches off the upper and lower ROMs, and moves a block of memory 
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Entry 
Exit 
&B91E 
Action 


Entry 


Exit 
&B921 
Action 


Entry 
Exit 


&B92A 
Action 
Entry 
Exit 


Notes 
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As for a standard LDIR instruction (ie DE holds the destination location, HL points to the first byte to be 
moved, and BC holds the length of the block to be moved) 


F, BC, DE amd HL are set as for a normal LDIR instruction, and all other registers are preserved 
KL LDDR 
Switches off the upper and lower ROMs, amd moves a block of memory 


As for a standard LDDR instruction (ie DE holds the first desination location, HL points to the highest 
byte lit in memory to be moved, amd BC holds the number of bytes to be moved) 


F, BC, DE amd HL, are set as for a nommal LDDR instruction, and all other registers are preserved 
KL POLL SYNCHRONOUS 

Tests whether an event with a higher priority than the current event is waiting to be dealt with 

No entry conditions 


If there is a higher priority event, then Carry is false; if there is no higher priority event, then Carry is true; 
in either case, A and the other flags are corrupt, and all other registers are preserved 


KL SCAN NEEDED 

Ensures that the keyboard is scanned when the next ticker interrupt occurs 
No entry conditions 

AF amd HL are corrupt, amd all other registers are preserved 


This routine is useful for scanning the keyboard when interrupts are disabled and normal key scanning is 
not occuring 
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The Key Manager 


&BBO00 


Action 


Entry 
Exit 
&BB03 
Action 
Entry 
Exit 


Notes 


&BBO06 
Action 
Entry 
Exit 
&BBO09 
Action 
Entry 
Exit 


&BBOC 
Action 
Entry 
Exit 
&BBOF 


Action 


Entry 


Exit 
&BB12 


Action 


Entry 
Exit 
&BB15 
Action 
Entry 
Exit 


Notes 


KM INITIALISE 


Initialises the Key Manager and sets up everything as it is when the computer is first switched on; the 
key buffer is emptied, Shift and Caps lock are tumed off amd all the expansion and translation tables are 
reset to normal; also see the routine KM RESET below 


No entry conditions 

AF, BC, DE and HL corrupt, and all other registers are preserved 

KM RESET 

Resets the Key Manager; the key buffer is emptied and all current keys/characters are ignored 
No entry conditions 

AF, BC, DE and HL are corrupt and all other registers are preserved 


See also KM INITIALISE above. On the 664 or 6128, the key buffer can also be cleared separately by 
calling the KM FLUSH routine 


KM WAIT CHAR 
Waits for the next character from the keyboard buffer 
No entry conditions 


Carry is true, A holds the character value, the other flags are corrupt, and all other registers are 
preserved 


KM READ CHAR 


Tests to see if a character is available from the keyboard buffer, but doesn't wait for one to become 
available 


No entry conditions 


If a character was available, then Carry is true, and A contains the character; otherwise Carry is false, 
and A is corrupt; in both cases, the other registers are preserved 


KM CHAR RETURN 

Saves a character for the next use of KM WAIT CHAR or KM READ CHAR 
A contains the ASCII code of the character to be put back 

All registers are preserved 

KM SET EXPAND 

Assigns a string to a key code 


B holds the key code; C holds the length of the string; HL contains the address of the string (must be in 
RAM) 


If it is OK, then Carry is true; otherwise Carry is false; in either case, A, BC, DE and HL are corrupt, and 
all other registers rlre preserved 


KM GET EXPAND 
Reads a character from an expanded string of characters 
A holds an expansion token (ie a key code) and L holds the character position number (starts from 0) 


If it is OK, then Carry is true, and A holds the character; otherwise Carry is false, and A is corrupt; in 
either case, DE and flags are corrupt, and the other registers are preserved 


KM EXP BUFFER 

Sets aside a buffer area for character expansion strings 

DE holds the address of the buffer and HL holds the length of the buffer 

If it is OK, then Carry is true; otherwise Carry is false; in either case, A, BC, DE and HL are corrupt 


The buffer must be in the central 32K of RAM and must be at least 49 bytes long 


The Amstrad CPC Firmware Guide 43 


&BB18 
Action 
Entry 
Exit 
&BB1B 
Action 


Entry 
Exit 


Notes 
&BB1E 
Action 


Entry 


Exit 


Notes 


&BB21 
Action 


Entry 


Exit 


&BB24 
Action 
Entry 
Exit 


Notes 


&BB27 
Action 
Entry 
Exit 


Notes 


&BB2A 
Action 
Entry 
Exit 


AA 


KM WAIT KEY 

Waits for a key to be pressed - this routine does not expand any expansion tokens 

No entry conditions 

Carry is true, A holds the character or expansion token, and all other registers are preserved 
KM READ KEY 

Tests whether a key is available from the keyboard 

No entry conditions 


If a key is available, then Carry is true, and A contains the character; otherwise Carry is false, and A is 
corrupt; in either case, the other registers are preserved 


Any expansion tokens are not expanded 

KM TEST KEY 

Tests if a particular key (or joystick direction or button) is pressed 
A contains the key/joystick nurnber 


If the requested key is pressed, then Zero is false; otherwise Zero is true for both, Carry is false A and 
HL are corrupt. C holds the Sbift and Control status and others are preserved 


After calling this, C will hold the state of shift and control - if bit 7 is set then Control was pressed, and if 
bit 5 is set then Shift was pressed 


KM GET STATE 
Gets the state of the Shift and Caps locks 
No entry conditions 


If L holds &FF then the shift lock is on, but if L holds &00 then the Shift lock is off; if H holds &FF then 
the caps lock is on, and if H holds &00 then the Caps lock is off; whatever the outcome, all the other 
registers are preserved 


KM GET JOYSTICK 

Reads the present state of any joysticks attached 

No entry conditions 

H and A contains the state of joystick 0, L holds that state of joystick 1, and all others are preserved 


The joystick states are bit significant and are as follows 

Bit 0 - Up Bit 

1 - Down Bit 

2 - Left Bit 

3 - Right Bit 

4 - Fire2 Bit 

5 - Fire’ Bit 

6 - Spare Bit 

7 - Always zero 

The bits are set when the corresponding buttons or directions are operated 


KM SET TRANSLATE 

Sets the token or character that is assigned to a key when neither Shift nor Control are pressed 
A contains the key number and B contains the new token or character 

AF and HL are corrupt, and all other registers are preserved 


Special values for B are as follows 

&80 to &9F - these values correspond to the expansion tokens 
&FD - this causes the caps lock to toggle on and off 

&FE - this causes the shift lock to toggle on and off 

&FF - causes this key to be ignored 


KM GET TRANSLATE 
Finds out what token or character will be assigned to a key when neither Shift nor Control are pressed 
A contains the key number 


A contains the token/character that is assigned, HL and flags are corrupt, and all others are preserved 
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Notes 
&BB2D 
Action 
Entry 
Exit 
Notes 
&BB30 
Action 
Entry 
Exit 


Notes 


&BB33 
Action 
Entry 
Exit 
Notes 
&BB36 
Action 
Entry 
Exit 
Notes 
&BB39 
Action 
Entry 
Exit 
&BB3C 
Action 
Entry 
Exit 
&BB3F 
Action 
Entry 
Exit 
Notes 
&BB42 
Action 


Entry 
Exit 


&BB45 


Action 


See KM SET TRANSLATE for special values that can be returned 

KM SET SHIFT 

Sets the token or character that will be assigned to a key when Shift is pressed as well 

A contains the key number and B contains the new token or character 

AF and HL are corrupt, and all others are preserved 

See KM SET TRANSLATE for special values that can be set 

KM GET SHIFT 

Finds out what token/character will be assigned to a key when Shift is pressed as well 

A contains the key number 

A contains the token/character that is assigned, HL and flags are corrupt, and all others are preserved 


See KM SET TRANSLATE for special values that can be returned 


KM SET CONTROL 

Sets the token or character that will be assigned to a key when Control is pressed as well 
A contains the key number and B contains the new token/character 

AF and HL are corrupt, and all others are preserved 

See KM SET TRANSLATE for special values that can be set 

KM GET CONTROL 

Finds out what token or character will be assigned to a key when Control is pressed as well 
A contains the key number 

A contains the token/character that is assigned, HL and flags are corrupt and all others are preserved 
See KM SET TRANSLATE for special values that can be set 

KM SET REPEAT 

Sets whether a key may repeat or not 

A contains the key number B contains &00 if there is no repeat and &FF is it is to repeat 
AF, BC and HL are corrupt, and all others are preserved 

KM GET REPEAT 

Finds out whether a key is set to repeat or not 

A contains a key number 


If the key repeats, then Zero is false; if the key does not repeat, then Zero is true; in either case, A, HL 
and flags are corrupt, Carry is false, and all other registers are preserved 


KM SET DELAY 

Sets the time that elapses before the first repeat, and also set the repeat speed 

H contains the time before the first repeat, and L holds the time between repeats (repeat speed) 
AF is corrupt, and all others are preserved 

The values for the times are given in 1/5Oth seconds, and a value of 0 counts as 256 

KM GET DELAY 

Finds out the time that elapses before the first repeat and also the repeat speed 

No entry conditions 


H contains the time before the first repeat, and L holds the time between repeats, and all others are 
preserved 


KM ARM BREAK 


Arms the Break mechanism 
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Entry 
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DE holds the address of the Break handling routine, C holds the ROM select address for this routine 
AF, BC, DE and HL are corrupt, and all the other registers are preserved 

KM DISARM BREAK 

Disables the Break mechanism 

No entry conditions 

AF and HL are corrupt, and all the other registers are preserved 

KM BREAK EVENT 

Generates a Break interrupt if a Break routine has been specified by KM ARM BREAK 

No entry conditions 


AF and HL are corrupt, and all other registers are preserved 
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The Text VDU 


&BB4E 


Action 


Entry 
Exit 
&BB51 
Action 
Entry 
Exit 
&BB54 
Action 
Entry 
Exit 
&BB57 
Action 
Entry 
Exit 
&BB5A 
Action 
Entry 
Exit 


Notes 


&BB5D 
Action 
Entry 
Exit 
Notes 
&BB60 
Action 


Entry 


Exit 


Notes 
&BB63 
Action 
Entry 
Exit 


Notes 


TXT INITIALISE 


Initialise the text VDU to its settings when the computer is switched on, includes resetting all the text 
VDU indirections, selecting Stream 0, resetting the text paper to pen O and the text pen to pen 1, 
moving the cursor to the top left corner of the screen and setting the writing mode to be opaque 


No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 

TXT RESET 

Resets the text VDU indirections and the control code table 

No entry conditions 

AF, BC, DE and HL are corrupt, and all the other registers are preserved 
TXT VDU ENABLE 

Allows characters to be printed on the screen in the current stream 
No entry conditions 

AF is corrupt, and all other registers are preserved 

TXT VDU DISABLE 

Prevents characters from being printed to the current stream 

No entry conditions 

AF is corrupt, and al1 the other registers are preserved 

TXT OUTPUT 

Output a character or control code (&00 to &1F) to the screen 

A contains the character to output 

All registers are preserved 


Any control codes are obeyed and nothing is printed if the VDU is disabled; characters are printed using 
the TXT OUT ACTION routine; if using graphics printing mode, then control codes are printed and not 
obeyed 


TXT WR CHAR 

Print a character at the current cursor position - control codes are printed and not obeyed 
A contains the character to be printed 

AF, BC, DE and HL are corrupt, and all others are preserved 

This routine uses the TXT WRITE CHAR indirection to put the character on the screen 
TXT RD CHAR 

Read a character from the screen at the current cursor position 

No entry conditions 


If it was successful then A contains the character that was read from the screen and Carry is true; 
otherwise Carry is false, and A holds 0; in either case, the other flags are corrupt, and all registers are 
preserved 


This routine uses the TXT UNWRITE indirection 

TXT SET GRAPHIC 

Enables or disables graphics print character mode 

To switch graphics printing mode on, A must be non- zero; to turn it off, A must contain zero 
AF corrupt, and all other registers are preserved 


When turned on, control codes are printed and not obeyed; characters are printed by GRA WR CHAR 
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Action 
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TXT WIN ENABLE 
Sets the boundaries of the current text window - uses physical coordinates 


H holds the column number of one edge, D holds the column number of the other edge, L holds the line 
number of one edge, and E holds the line number of the other edge 


AF, BC, DE and HL are corrupt 

The window is not cleared but the cursor is moved to the top left corner of the window 
TXT GET WINDOW 

Returns the size of the current window - returns physical coordinates 

No entry conditions 


H holds the column number of the left edge, D holds the column number of the right edge, L holds the 
line number of the top edge, E holds the line number of the bottom edge, A is corrupt, Carry is false if 
the window covers the entire screen, and the other registers are always preserved 


TXT CLEAR WINDOW 

Clears the window (of the current stream) and moves the cursor to the top left corner of the window 
No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 
TXT SET COLUMN 

Sets the cursor's horizontal position 

A contains the logical column number to move the cursor to 

AF and HL are corrupt, and all the other registers are preserved 
See also TXT SET CURSOR 

TXT SET ROW 

Sets the cursor's vertical position 

A contains the logical line number to move the cursor to 

AF and HL are corrupt, and all others are preserved 

See also TXT SET CURSOR 

TXT SET CURSOR 

Sets the cursor's vertical and horizontal position 

H contains the logical column number and L contains the logical line number 
AF and HL are corrupt, and all the others are preserved 

See also TXT SET COLUMN and TXT SET ROW 

TXT GET CURSOR 

Gets the cursor's current position 

No entry conditions 


H holds the logical column number, L holds the logical line number, and A contains the roll count, the 
flags are corrupt, and all the other registers are preserved 


The roll count is increased when the screen is scrolled down, and is decreased when it is scrolled up 


TXT CUR ENABLE 

Allows the text cursor to be displayed (if it is allowed by TXT CUR ON) - intended for use by the user 
No entry conditions 

AF is corrupt, and all other registers are preserved 

TXT CUR DISABLE 


Prevents the text cursor from being displayed -intended for use by the user 
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&BB8D 
Action 
Entry 
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Notes 
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Action 
Entry 
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Action 
Entry 
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Action 


Entry 


No entry conditions 

AF is corrupt, and all others are preserved 

TXT CUR ON 

Allows the text cursor to be displayed - intended for use by the operating system 
No entry conditions 

All registers and flags are preserved 

TXT CUR OFF 

Prevents the text cursor from being displayed -intended for use by the operating system 
No entry conditions 

All registers and flags are preserved 

TXT VALIDATE 

Checks whether a cursor position is within the current window 

H contains the logical column number to check, and L holds the logical line number 


H holds the logical column number where the next character will be printed, L holds the logical line 
number; if printing at this position would make the window scroll up, then Carry is false and B holds 
&FF; if printing at this position would make the window scroll down, then Carry is false and B contains 
&00; if printing at the specified cursor position would not scroll the window, then Carry is true and B is 
corrupt; always, A and the other flags are corrupt, and all others are preserved 


TXT PLACE CURSOR 

Puts a ‘cursor blob’ on the screen at the current cursor position 
No entry conditions 

AF is corrupt, and all other registers are preserved 


It is possible to have more than one cursor in a window (see also TXT DRAW CURSOR); do not use 
this routine twice without using TXT REMOVE CURSOR between 


TXT REMOVE CURSOR 

Removes a ‘cursor blob’ from the current cursor position 
No entry conditions 

AF is corrupt, and all the others are preserved 


This should be used only to remove cursors created by TXT PLACE CURSOR, but see also TXT 
UNDRAW CURSOR 


TXT SET PEN 

Sets the foreground PEN for the current stream 

A contams the PEN number to use 

AF and HL are corrupt, and all other registers are preserved 
TXT GET PEN 

Gets the foreground PEN for the current stream 

No entry conditions 

A contains the PEN number, the flags are corrupt, and all other registers are preserved 
TXT SET PAPER 

Sets the background PAPER for the current stream 

A contains the PEN number to use 

AF and HL are corrupt, and all other registers are preserved 
TXT GET PAPER 

Gets the background PAPER for the current stream 


No entry conditions 
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A contains the PEN number, the flags are corrupt, and all other registers are preserved 
TXT INVERSE 

Swaps the current PEN and PAPER colours over for the current stream 

No entry conditions 

AF and HL are corrupt, and all others are preserved 

TXT SET BACK 

Sets the character write mode to either opaque or transparent 

For transparent mode, A must be non-zero; for opaque mode, A has to hold zero 
AF and HL are corrupt, and all other registers are preserved 

Setting the character write mode has no effects on the graphics VDU 

TXT GET BACK 

Gets the character write mode for the current stream 

No entry conditions 


If in transparent mode, A is non-zero; in opaque mode, A is zero; in either case DE, HL and flags are 
corrupt, and the other registers are preserved 


TXT GET MATRIX 
Gets the address of a character matrix 
A contains the character whose matrix is to be found 


If it is a user-defined matrix, then Carry is true; if it is in the lower ROM then Carry is false; in either 
event, HL contains the address of the matrix, A and other flags are corrupt, and others are preserved 


The character matrix is stored in 8 bytes; the first byte is for the top row of the character, and the last 
byte refers to the bottom row of the character; bit 7 of a byte refers to the leftmost pixel of a line, and bit 
O refers to the rightmost pixel in Mode 2. 


TXT SET MATRIX 
Installs a matrix for a user-defined character 
A contains the character which is being defined and HL contains the address of the matrix to be used 


If the character is user-definable then Carry is true; otherwise Carry is false, and no action is taken; in 
both cases AF, BC, DE and HL are corrupt, and all other registers are preserved 


TXT SET M TABLE 
Sets the address of a user-defined matrix table 
DE is the first character in the table and HL is the table's address (in the central 32K of RAM) 


If there are no existing tables then Carry is false, and A and HL are both corrupt; otherwise Carry is 
true, A is the first character and HL is the table's address; in both cases BC, DE and the other flags are 
corrupt 


TXT GET M TABLE 

Gets the address of a user-defined matrix table 

No entry conditions 

See TXT SET M TABLE above for details of the values that can be returned 
TXT GET CONTROLS 

Gets the address of the control code table 

No entry conditions 

HL contains the address of the table, and all others are preserved 


The table has 32 entries, and each entry has three bytes 
byte 1 is the number of parameters needed by the control code 
bytes 2 and 3 are the address of the routine, in the Lower ROM, to execute the control code 


TXT STR SELECT 
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Selects a new VDU text stream 

A contains the value of the stream to change to 

A contains the previously selected stream, HL and the flags are corrupt, and all others are preserved 
TXT SWAP STREAMS 

Swaps the states of two stream attribute tables 

B contains a stream number, and C contains the other stream number 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


The foreground pen and paper, the window size, the cursor position, the character write mode and 
graphic character mode are all exchanged between the two streams 
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GRA INITIALISE 

Initialises the graphics VDU to its default set-up (ie its set-up when the computer is switched on) 
No entry conditions 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


Sets the graphics indirections to their defaults, sets the graphic paper to text pen O and the graphic pen 
to text pen 1, reset the graphics origin and move the graphics cursor to the bottom left of the screen, 
reset the graphics window and write mode to their defaults 


GRA RESET 

Resets the graphics VDU 

No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 

Resets the graphics indirections and the graphics write mode to their defaults 
GRA MOVE ABSOLUTE 

Moves the graphics cursor to an absolute screen position 

DE contains the user X-coordinate and HL holds the user Y-coordinate 
AF, BC, DE and HL are corrupt, and all other registers are preserved 
GRA MOVE RELATIVE 

Moves the graphics cursor to a point relative to its present screen position 
DE contains the X-distance to move and HL holds the Y-distance 

AF, BC, DE and HL are corrupt, and all others are preserved 

GRA ASK CURSOR 

Gets the graphics cursor's current position 

No entry conditions 


DE holds the user X-coordirlate, HL holds the user Y-coordinate, AF is corrupt, and all others nre 
preserved 


GRA SET ORIGIN 

Sets the graphics user origin's screen position 

DE contains the standard X-coordinate and HL holds the standard Y-coordinate 
AF, BC, DE and HL are corrupt, and all other registers are preserved 

GRA GET ORIGIN 

Gets the graphics user origin's screen position 

No entry conditions 


DE contains the standard X-coordinate and HL holds the standard Y-coordinate, and all others are 
preserved 


GRA WIN WIDTH 
Sets the left and right edges of the graphics window 


DE contains the standard X-coordinate of one edge and HL holds the standard X-coordinate of the 
other side 


AF, BC, DE and HL are corrupt, and all the other registers are preserved 


The default window covers the entire screen and is restored to its default when the mode is changed; 
used in conjunction with GRA WIN HEIGHT 


GRA WIN HEIGHT 
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Sets the top and bottom edges of the graphics window 


DE contains the standard Y-coordinate of one side and HL holds the standard Y-coordinate of the other 
side 


AF, BC, DE and HL are corrupt, and all others are preserved 
See GRA WIN WIDTH for further details 

GRA GET W WIDTH 

Gets the left and right edges of the graphics window 

No entry conditions 


DE contains the standard X-coordinate of the left edge and HL contains the standard Y-coordinate of 
the right edge, AF is corrupt, and all other registers are preserved 


GRA GET W HEIGHT 
Gets the top and bottom edges of the graphics window 
No entry conditions 


DE contains the standard Y-coordinate of the top edge and HL contains the standard Y-coordinate of 
the bottom edge, AF is corrupt, and all other registers are preserved 


GRA CLEAR WINDOW 

Clears the graphics window to the graphics paper colour and moves the cursor back to the user origin 
No entry conditions 

AF, BC, DE and HL are corrupt, and all other registers are preserved 

GRA SET PEN 

Sets the graphics PEN 

A contains the required text PEN number 

AF is corrupt, and all other registers are preserved 

GRA GET PEN 

Gets the graphics PEN 

No entry conditions 

A contains the text PEN number, the flags are corrupt, and all other registers are preserved 
GRA SET PAPER 

Sets the graphics PAPER 

A contains the required text PEN number 

AF corrupt, and all others are preserved 

GRA GET PAPER 

Gets the graphics PAPER 

No entry conditions 

A contains the text PEN number, the flags are corrupt, and all others are preserved 

GRA PLOT ABSOLUTE 

Plots a point at an absolute user coordinate, using the GRA PLOT indirection 

DE contains the user X-coordinate and HL holds the user Y-coordinate 

AF, BC, DE and HL are corrupt, and all others are preserved 

GRA PLOT RELATIVE 

Plots a point at a position relative to the current graphics cursor, using the GRA PLOT indirection 
DE contains the relative X-coordinate and HL contains the relative Y-coordinate 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


GRA TEST ABSOLUTE 
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Moves to an absolute position, and tests the point there using the GRA TEST indirection 

DE contains the user X-coordinate and HL holds the user Y-coordinate for the point you wish to test 
A contains the pen at the point, and BC, DE, HL and flags are corrupt, and all others are preserved 
GRA TEST RELATIVE 


Moves to a position relative to the current position, and tests the point there using the GRA TEST 
indirection 


DE contains the relative X-coordinate and HL contains the relative Y-coordinate 

A contains the pen at the point, and BC, DE, HL and flags are corrupt, and all others are preserved 
GRA LINE ABSOLUTE 

Draws a line from the current graphics position to an absolute position, using GRA LINE 

DE contains the user X-coordinate and HL holds the user Y-coordinate of the end point 

AF, BC, DE and HL are corrupt, and all others are preserved 


The line will be plotted in the current graphics pen colour (may be masked to produce a dotted line ona 
6128) 


GRA LINE RELATIVE 

Draws a line from the current graphics position to a relative screen position, using GRA LINE 
DE contains the relative X-coordinate and HL contains the relative Y-coordinate 

AF, BC, DE and HL are corrupt, and all other registers are preserved 

See GRA LINE ABSOLUTE above for details of how the line is plotted 

GRA WR CHAR 

Writes a character onto the screen at the current graphics position 

A contains the character to be put onto the screen 

AF, BC, DE and HL are corrupt, and all the other registers are preserved 


As in BASIC, all characters including control codes are printed; the character is printed with its top left 
corner at the current graphics position; the graphics position is moved one character width to the right 
so that it is ready for another character to be printed 
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SCR INITIALISE 

Initialises the Screen Pack to the default values used when the computer is first switched on 
No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 


All screen indirections are restored to their default settings, as are inks and flashing speeds; the mode is 
switched to MODE 1 and the screen is cleared with PEN 0; the screen address is moved to &CO00 and 
the screen offset is set to zero 


SCR RESET 

Resets the Screen Pack's indirections, flashing speeds and inks to their default values 
No entry conditions 

AF, BC, DE r1nd HL are corrupt, and all other registers are preserved 

SCR SET OFFSET 

Sets the screen offset to the specified values - this can cause the screen to scroll 

HL contains the required offset, which should be even 

AF and HL are corrupt, and all others are preserved 


The screen offset is reset to 0 whenever its mode is set, or it is cleared by SCR CLEAR (but not 
BASIC's CLS) 


SCR SET BASE 

Sets the location in memory of the screen - effectively can only be &CO00 or &4000 
A contains the most significant byte of the screen address required 

AF and HL are corrupt, and all other registers are preserved 


The screen memory can only be set at 16K intervals (ie &0000, &4000, &8000, &C000) and when the 
computer is first switched on the 16K of screen memory is located at &CO00) 


SCR GET LOCATION 
Gets the location of the screen memory and also the screen offset 
No entry conditions 


A holds the most significant byte of the screen address, HL holds the current offset, and all others are 
preserved 


SCR SET MODE 

Sets the screen mode 

A contains the mode number - it has the same value and characteristics as in BASIC 
AF, BC, DE and HL are corrupt, and all others are preserved 


The windows are set to cover the whole screen and the graphics origin is set to the bottom left corner of 
the screen; in addition, the current stream is set to zero, and the screen offset is zeroed 


SCR GET MODE 
Gets the current screen mode 
No entry conditions 


If the mode is 0, then Carry is true, Zero is false, and A contains 0; if the mode is 1, then Carry is false, 
Zero is true, and A contains 1; if the mode is 2, then Carry is false, Zero is false, and A contains 2; in all 
cases the other flags are corrupt and all the other registers are preserved 


SCR CLEAR 
Clears the whole of the screen 


No entry conditions 
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AF, BC, DE and HL are corrupt, and all others are preserved 

SCR CHAR LIMITS 

Gets the size of the whole screen in terms of the numbers of characters that can be displayed 
No entry conditions 


B contains the number of characters across the screen, C contains the number of characters down the 
screen, AF is corrupt, and all other registers are preserved 


SCR CHAR POSITION 
Gets the memory address of the top left corner of a specified character position 
H contains the character physical column and L contains the character physical row 


HL contains the memory address of the top left comer of the character, B holds the width in bytes of a 
character in the present mode, AF is corrupt, and all other registers are preserved 


SCR DOT POSITION 
Gets the memory address of a pixel at a specified screen position 
DE contains the base X-coordinate of the pixel, and HL contains the base Y-coordinate 


HL contains the memory address of the pixel, C contains the bit mask for this pixel, B contains the 
number of pixels stored in a byte minus 1, AF and DE are corrupt, and all others are preserved 


SCR NEXT BYTE 


Calculates the screen address of the byte to the right of the specified screen address (may be on the 
next line) 


HL contains the screen address 


HL holds the screen address of the byte to the right of the original screen address, AF is corrupt, all 
others are preserved 


SCR PREV BYTE 


Calculates the screen address of the byte to the left of the specified screen address (this address may 
actually be on the previous line) 


HL contains the screen address 


HL holds the screen address of the byte to the left of the original address, AF is corrupt, all others are 
preserved 


SCR NEXT LINE 
Calculates the screen address of the byte below the specified screen address 
HL contains the screen address 


HL contains the screen address of the byte below the original screen address, AF is corrupt, and all the 
other registers are preserved 


SCR PREV LINE 
Calculates the screen address of the byte above the specified screen address 
HL contains the screen address 


HL holds the screen address of the byte above the original address, AF is corrupt, and all others are 
preserved 


SCR INK ENCODE 


Converts a PEN to provide a mask which, if applied to a screen byte, will convert all of the pixels in the 
byte to the appropriate PEN 


A contains a PEN number 

A contains the encoded value of the PEN, the flags are corrupt, and all other registers are preserved 
The mask returned is different in each of the screen modes 

SCR INK DECODE 

Converts a PEN mask into the PEN number (see SCR INK ENCODE for the re~ erse process) 


A contains the encoded value of the PEN 
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A contains the PEN number, the flags are corrupt, and all others are preserved 

SCR SET INK 

Sets the colours of a PEN - if the two values supplied are different then the colours will alternate (flash) 
contains the PEN number, B contains the first colour, and C holds the second colour 

AF, BC, DE and HL are corrupt, and all others are preserved 

SCR GET INK 

Gets the colours of a PEN 

A contains the PEN nurnber 


B contains the first colour, C holds the second colour, and AF, DE and HL are corrupt, and all others are 
preserved 


SCR SET BORDER 

Sets the colours of the border - again if two different values are supplied, the border will flash 
B contains the first colour, and C contains the second colour 

AF, BC, DE and HL are corrupt, and all others are preserved 

SCR GET BORDER 

Gets the colours of the border 

No entry conditions 


B contains the first colour, C holds the second colour, and AF, DE and HL are corrupt, and all others are 
preserved 


SCR SET FLASHING 

Sets the speed with which the border's and PENs' colours flash 

H holds the time that the first colour is displayed, L holds the time the second colour is displayed for 
AF and HL are corrupt, and all other registers are preserved 


The length of time that each colour is shown is measured in 1/5Oths of a second, and a value of 0 is 
taken to mean 256 * 1/50 seconds - the default value is 10 * 1/50 seconds 


SCR GET FLASHING 
Gets the periods with which the colours of the border and PENs flash 
No entry conditions 


H holds the duration of the first colour, L holds the duration of the second colour, AF is corrupt, and all 
other registers are preserved - see SCR SET FLASHING for the units of time used 


SCR FILL BOX 
Fills an area of the screen with an ink - this only works for “character-sized' blocks of screen 


A contains the mask for the ink that is to be used, H contains the left hand colurnn of the area to fill, D 
contains the right hand column, L holds the top line, and E holds the bottom line of the area (using 
physical coordinates) 


AF, BC, DE and HL are corrupt, and all others are preserved 
SCR FLOOD BOX 
Fills an area of the screen with an ink - this only works for *byte-sized' blocks of screen 


C contains the encoded PEN that is to be used, HL contains the screen address of the top left hand 
corner of the area to fill, D contains the width of the area to be filled in bytes, and E contains the height 
of the area to be filled in screen lines 


AF, BC, DE and HL are corrupt, and all other registers are preserved 
The whole of the area to be filled must lie on the screen otherwise unpredictable results may occur 
SCR CHAR INVERT 


Inverts a character's colours; all pixels in one PEN's colour are printed in another PEN's colour, and vice 
versa 
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B contains one encoded PEN, C contains the other encoded PEN, H contains the physical column 
number, and L contains the physical line number of the character that is to be inverted 


AF, BC, DE and HL are corrupt, and all the other registers are preserved 
SCR HW ROLL 
Scrolls the entire screen up or down by eight pixel rows (ie one character line) 


B holds the direction that the screen will roll, A holds the encoded PAPER which the new line will appear 
in 


AF, BC, DE and HL are corrupt, and all others are preserved 

This alters the screen offset; to roll down, B must hold zero, and to roll upwards B must be non-zero 
SCR SW ROLL 

Scrolls part of the screen up or down by eight pixel lines - only for ‘character-sized' blocks of the screen 


B holds the direction to roll the screen, A holds the encoded PAPER which the new line will appear in, H 
holds the left column of the area to scroll, D holds the right colurnn, L holds the top line, E holds the 
bottom line 


AF, BC, DE and HL are corrupt, and all other registers are preserved 


The area of the screen is moved by copying it; to roll down, B must hold Zero, and to roll upwards B 
must be non-zero; this routine uses physical roordinates 


SCR UNPACK 


Changes a character matrix from its eight byte standard form into a set of pixel masks which are suitable 
for the current mode - four *8 bytes are needed in mode 0, two *8 bytes in mode |, and 8 bytes in mode 
2 


HL contains the address of the matrix, and DE contains the address where the masks are to be stored 
AF. BC, DE and HL are corrupt, and all other registers are preserved 

SCR REPACK 

Changes a set of pixel masks (for the current mode) into a standard eight byte character matrix 


A contains the encoded foreground PEN to be matched against (ie the PEN that is to be regarded as 

being set in the character), H holds the physical column of the character to be ‘repacked', L holds the 
physical line of the character, and DE contains the address of the area where the character matrix will 
be built 


AF, BC, DE amd HL are corrupt, and all the others are preserved 
SCR ACCESS 

Sets the screen write mode for graphics 

A contains the write mode (0=Fill, 1=XOR, 2=AND, 3=OR) 

AF. BC, DE and HL are corrupt, amd all other registers are preserved 


The fill mode means that the ink that plotting was requested in is the ink that appears on the screen; in 
XOR mode, the specified ink is XORed with ink that is at that point on the screen already before plotting; 
a similar situation occurs with the AND and OR modes 


SCR PIXELS 
Puts a pixel or pixels on the screen regardless of the write mode specified by SCR ACCESS above 


B contains the mask of the PEN to be drawn with, C contains the pixel mask, and HL holds the screen 
address of the pixel 


AF is corrupt, amd all others are preserved 
SCR HORIZONTAL 
Draws a honzontal line on the screen using the current graphics write mode 


A contains the encoded PEN to be drawn with, DE contains the base X-coordinate of the start of the 
line, BC contains the end base X-coordinate, and HL contains the base Y-coordinate 


AF, BC, DE and HL are conupt, and all other registers are preserved 


The start X-coordinate must be less than the end X- coordmate 
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Draws a vertical line on the screen using the current graphics write mode 


A contains the encoded PEN to be drawn with, DE contains the base X-coordinate of the line, HL holds 
the start base Y-coordinate, and BC contains the end base Y-coordinate - the start coordinate must be 
less than the end coordinate 


AF, BC, DE and HL are corrupt, and all the other registers are preserved 
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The Cassette/AMSDOS manager 


NOTE: Some of these routines are only applicable to the cassette manager; where a disc version 
exists it is indicated by an asterisk (*) next to the command name. These disc version jumpblocks are 
automatically installed by the Operating System on switch on. 
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CAS INITIALISE 

Initialises the cassette manager 

No entry conditions 

AF, BC, DE and HL are corrupt, and all the other registers are preserved 

Both read and write streams are closed; tape messages are switched on; the default speed is reselected 
CAS SET SPEED 

Sets the speed at which the cassette manager saves programs 

HL holds the length of “half a zero’ bit, and A contains the amount of precompensation 

AF and HL are corrupt 


The value in HL is the length of time that half a zero bit is written as; a one bit is twice the length of a 
zero bit; the default values (ie SPEED WRITE 0) are 333 microseconds (HL) and 25 microseconds (A) 
for SPEED WRITE 1, the values are given as 107 microseconds and 50 microseconds respectively 


CAS NOISY 

Enables or disables the display of cassette handling messages 

To enable the messages then A must be 0, otherwise the messages are disabled 
AF is corrupt, and all other registers are preserved 

CAS START MOTOR 

Switches on the tape motor 

No entry conditions 


If the motor operates properly then Carry is true; if ESC was pressed then Carry is false; in either case, 
A contains the motor's previous state, tbe flags are corrupt, and all others are preserved 


CAS STOP MOTOR 
Switches off the tape motor 
No entry conditions 


If the motor turns off then Carry is true; if ESC was pressed then Carry is false; in both cases, A holds 
tbe motor's previous state, the other flags are corrupt, all others are preserved 


CAS RESTORE MOTOR 
Resets the tape motor to its previous state 
A contains the previous state of the motor (eg from CAS START MOTOR or CAS STOP MOTOR) 


If the motor operates properly then Carry is true; if ESC was pressed then Carry is false; in all cases, A 
and the other flags are corrupt and all others are preserved 


*CAS IN OPEN 
Opens an input buffer and reads the first block of the file 


B contains the length of the filename, HL contains the filename's address, and DE contains the address 
of the 2K buffer to use for reading the file 


If the file was opened successfully, then Carry is true, Zero is false, HL holds the address of a buffer 
contauling the file header data, DE holds the address of the destination for the file, BC holds the file 
length, and A holds the file type; if the read stream is already open then Carry and Zero are false, A 
contains an error nurnber (664/6128 only) and BC, DE and HL are corrupt; if ESC was pressed by the 
user, then Carry is false, Zero is true, A holds an error number (664/6128 only) and BC, DE and HL are 
corrupt; in all cases, IX and the other flags are corrupt, and the others are preserved 
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A filename of zero length means ‘read the next file on the tape’; the stream remains open until it is 
closed by either CAS IN CLOSE or CAS IN ABANDON 


Similar to tape except that if there is no header on the file, then a fake header is put into memory by this 
routine 


*CAS IN CLOSE 
Closes an input file 
No entry conditions 


If the file was closed successfully, then Carry is true and A is corrupt; if the read stream was not open, 
then Carry is false, and A holds an error code (664/6128 only); in both cases, BC, DE, HL and the other 
flags are all corrupt 


All the above applies, but also if the file failed to close for any other reason, then Carry is false, Zero is 
true and A contains an error number; in all cases the drive motor is turned off immediately 


*CAS IN ABANDON 

Abandons an input file 

No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 
All the above applies for the disc routine 

*CAS IN CHAR 

Reads in a single byte from a file 

No entry conditions 


If a byte was read, then Carry is true, Zero is false, and A contains the byte read from the file; if the end 
of file was reached, then Carry and Zero are false, A contains an error number (664/6128 only) or is 
corrupt (for the 464); if ESC was pressed, then Carry is false, Zero is true, and A holds an error number 
(664/6128 only) or is corrupt (for the 464); in all cases, IX and the other flags are corrupt, and all others 
are preserved 


All the above applies for the disc routine 

*CAS IN DIRECT 

Reads an entire file directly into memory 

HL contains the address where the file is to be placed in RAM 


If the operation was successful, then Carry is true, Zero is false, HL contains the entry address and A is 
corrupt; if it was not open, then Carry and Zero are both false, HL is corrupt, and A holds an error code 
(664/6128) or is corrupt (464); if ESC was pressed, Carry is false, Zero is true, HL is corrupt, and A 
holds an error code (664/6128 only); in all cases, BC, DE and IX and the other flags are corrupt, and the 
others are preserved 


This routine cannot be used once CAS IN CHAR has been used 

All the above applies to the disc routine 

*CAS RETURN 

Puts the last byte read back into the input buffer so that it can be read again at a later time 
No entry conditions 

All registers are preserved 

The routine can only return the last byte read and at least one byte must have been read 
All the above applies to the disc routine 

*CAS TEST EOF 

Tests whether the end of file has been encountered 

No entry conditions 


If the end of file has been reached, then Carry and Zero are false, and A is corrupt; if the end of file has 
not been encountered, then Carry is true, Zero is false, and A is corrupt; if ESC was pressed then Carry 
is false, Zero is true and A contains an error number (664/6128 only); in all cases, IX and the other flags 
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are corrupt, and all others are preserved 
All the above applies to the disc routine 
*CAS OUT OPEN 

Opens an output file 


B contains the length of the filename, HL contains the address of the filename, and DE holds the 
address of the 2K buffer to be used 


If the file was opened correctly, then Carry is true, Zero is false, HL holds the address of the buffer 
containing the file header data that will be written to each block, and A is corrupt; if the write stream is 
already open, then Carry and Zero are false, A holds an error nurnber (66~/6128) and HL is corrupt; if 
ESC was pressed then Carry is false, Zero is true, A holds an error number (664/6128) and HL is 
corrupt; in all cases, BC, DE, IX and the other flags are corrupt, and the others are preserved 


The buffer is used to store the contents of a file block before it is actually written to tape 
The same as for tape except that the filename must be present in its usual AMSDOS format 
*CAS OUT CLOSE 

Closes an output file 

No entry conditions 


If the file was closed successfully, then Carry is true, Zero is false, and A is corrupt; if the write stream 
was not open, then Carry and Zero are false and A holds an error code (664/6128 only); if ESC was 
pressed then Carry is false, Zero is true, and A contains an error code (664/6128 only); in all cases, BC, 
DE, HL, IX and the other flags are all corrupt 


The last block of a file is written only when this routine is called; if writing the file is to be abandoned, 
then CAS OUT ABANDON should be used instead 


All the above applies to the disc routine 

*CAS OUT ABANDON 

Abandons an output file 

No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 

When using this routine, the current last block of the file is not written to the tape 


Similar to the tape routine; if more than 16K of a file has been written to the disc, then the first 16K of the 
file will exist on the disc with a file extension of .6$$ because each 16K section of the file requires a 
separate directory entry 


*CAS OUT CHAR 
Writes a single byte to a file 
A contains the byte to be written to the file output buffer 


If a byte was written to the buffer, then Carry is true, Zero is false, and A is corrupt; if the file was not 
open, then Carry and Zero are false, and A contains an error number (664/6128 only) or is corrupt (on 
the 464); if ESC was pressed, then Carry is false, Zero is true, and A contains an error number 
(664/6128 only) or it is corrupt (on the 464); in all cases, IX and the other flags are corrupt, and all 
others are preserved 


If the 2K buffer is full of data then it is written to the tape before the new character is placed in the buffer; 
it is important to call CAS OUT CLOSE when all the data has been sent to the file so that the last block 
is written to the tape 


All the above applies to the disc routine 
*CAS OUT DIRECT 
Writes an entire file directly to tape 


HL contains the address of the data which is to be written to tape, DE contains the length of this data, 
BC contains the e~ecution address, and A contains the file type 


If the operation was successful, then Carry is true, Zero is false, and A is corrupt; if the file was not 
open, Carry and Zero are false, A holds an error number (664/6128) or is corrupt (464); if ESC was 
pressed, then Carry is false, Zero is true, and A holds an error code (664/6128 only); in all cases BC, 
DE, HL, IX and the other flags are corrupt, and the others are preserved 
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This routine cannot be used once CAS OUT CHAR has been used 

All the above applies to the disc routine 

*CAS CATALOG 

Creates a catalogue of all the files on the tape 

DE contains the address of the 2K buffer to be used to store the information 


If the operation was successful, then Carry is true, Zero is false, and A is corrupt; if the read stream is 
already being used, then Carry and Zero are false, and A holds an error code (664/6128 or is corrupt 
(for the 464); in all cases, BC, DE, HL, IX and the other flags are corrupt and all others are preserved 


This routine is only left when the ESC key is pressed (cassette only) and is identical to BASIC's CAT 
command 


All tbe above applies, except that a sorted list of files is displayed; system files are not listed by this 
routine 


CAS WRITE 
Writes data to the tape in one long file (ie not in 2K blocks) 


HL contains the address of the data to be written to tape, DE contains the length of the data to be 
written, and A contains the sync character 


If the operation was successful, then Carry is true and A is corrupt; if an error occurred then Carry is 
false and A contains an error code; in both cases, BC, DE, HL and IX are corrupt, and all other registers 
are preserved 


For header records the sync character is &2C, and for data it is &16; this routine starts and stops the 
cassette motor and also tums off interrupts whilst writing data 


CAS READ 
Reads data from the tape in one long file (ie as originally written by CAS WRITE only) 


HL holds the address to place the file, DE holds the length of the data, and A holds the expected sync 
character 


If the operation was successful, then Carry is true and A is corrupt; if an error occurred then Carry is 
false and A contains an error code; in both cases, BC, DE, HL and IX are corrupt, and all other registers 
are preserved 


For header records the sync character is &2C, and for data it is &16; this routine starts and stops the 
cassette motor and turns off interrupts whilst reading data 


CAS CHECK 
Compares the contents of memory with a file record (ie header or data) on tape 


HL contains the address of the data to check, DE contains the length of the data and A holds the sync 
character that was used when the file was originally written to the tape 


If the two are identical, then Carry is true and A is corrupt; if an error occurred then Carry is false and A 
holds an error code; in all cases, BC, DE, HL, IX and other flags are corrupt, and all other registers are 
preserved 


For header records the sync character is &2C, and for data it is &16; this routine starts and stops the 
cassette motor and turns off interrupts whilst reading data; does not have to read the whole of a record, 
but must start at the beginning 
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BIOS SET MESSAGE 

Enables or disables disc error messages 

To enable messages, A holds &00; to disable messages, A holds &FF 

A holds the previous state, HL and the flags are corrupt, and all others are preserved 

Enabling and disabling the messages can also be achieved by poking &BE78 with &00 or &FF 
BIOS SETUP DISC 
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Sets the parameters which effect the disc speed 
HL holds the address of the nine bytes which make up the parameter block 
AF, BC, DE and HL are corrupt, and all other registers are preserved 


The parameter block is arranged as follows 

bytes 0&1 - the motor on time in 20ms units; the default is &0032; the fastest is &0023 
bytes 2&3 - the motor off time in 20ms units; the default is &00FA; the fastest is &00C8 
byte 4 - the write off time in |0zes units; the default is &AF; should not be changed 

byte 5 - the head settle time in 1ms units; the default is &0F; should not be changed 
byte 6 - the step rate time in 1ms units; the default is &0C; the fastest is &0A 

byte 7 - the head unload delay; the default is &01; should not be changed 

byte 8 - a byte of &03 and this should be left unaltered 


BIOS SELECT FORMAT 

Sets a format for a disc 

A holds the type of format that is to be selected 

AF, BC, DE and HL are corrupt, and all the other registers are preserved 


To select one of the normal disc formats, the following values should be put into the A register 

Data format - &C1 

System format - &41 - Used by CP/M 

IBM format - &01 - compatible with CP/M-86 

This routine sets the extended disc parameter block (XDPB) at &A890 to &A8A8 - to set other formats, 
the XDPB must be altered directly 


BIOS READ SECTOR 
Reads a sector from a disc into memory 


HL holds the address in memory where the sector will be read to, E holds the drive number (&00 for 
drive A, and &01 for drive B), D holds the track number, and C holds the sector number 


If the sector was read properly, then Carry is true, A holds 0, and HL is preserved; if the read failed, then 
Carry is false, A holds an error number, and HL is corrupt; in either case, the other flags are corrupt, and 
all other registers are preserved 


BIOS WRITE SECTOR 
Writes a sector from memory onto disc 


HL holds the address of memory which will be written to the disc, E holds the drive number (&00 for 
drive A, and &01 for drive B), D holds the track number, and C holds the sector number 


If the sector was written properly, then Carry is true, A holds 0, and HL is preserved; if the write failed, 
then Carry is false, A holds an error number, and HL is corrupt; in either case, the other flags are 
corrupt, and all other registers are preserved 


BIOS FORMAT TRACK 
Formats a complete track, inserts sectors, and fills the track with bytes of &E5 


HL contains the address of the header information buffer which holds the header information blocks, E 
contains the drive number (&00 for drive A, and &01 for drive B), and D holds the track number 


if the formatting process was successful, then Carry is true, A holds 0, and HL is preserved; if the 
formatting process failed, then Carry is false, A holds an error number, and HL is corrupt; in either case, 
the other flags are corrupt, and all the other registers are preserved 


The header information block is laid out as follows 

byte 0 - holds the track number 

byte 1 - holds the head number (set to zero) 

byte 2 - holds the sector number 

byte 3 - holds log2(sector size) -7 (usually either &02=512 bytes, or &03=1024 bytes). 

Header information blocks must be set up contiguously for every sector on the track, and in the same 
sequence that they are to be laid down (eg &C1, &C6, &C2, &C7, &C3, &C8, &C4, &C9, &C5) 


BIOS MOVE TRACK 
Moves the disc drive head to the specified track 
E holds the drive number (&00 for drive A, and &01 for drive B), and D holds the track number 


If the head was moved successfully, then Carry is true, A holds 0, and HL is preserved; if the move 
failed, then Carry is false, A holds an error number, and HL is corrupt; in both cases, the other flags are 
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corrupt, and all other registers are preserved 


There is normally no need to call this routine as READ SECTOR, WRITE SECTOR and FORMAT 
TRACK automatically move the head to the correct position 


BIOS GET STATUS 
Returns the status of the specified drive 
A holds the drive number (&00 for drive A, and &01 for drive B) 


If Carry is true, then A holds the status byte, and HL is preserved; if Carry is false, then A is corrupt, and 
HL holds the address of the byte before the status byte; in either case, the other flags are preserved, 
and all other registers are preserved 


The status byte indicates the drive's status as follows 

if bit 6 is set, then either the write protect is set or the disc is missing 

if bit 5 is set, then the drive is ready and the disc is fitted (whether the disc is formatted or not) 
if bit 4 is set, then the head is at track 0 


BIOS SET RETRY COUNT 

Sets the number of times the operation is retried in the event of disc error 

A holds the number of retries required 

A holds the previous number of retries, HL and the flags are corrupt, and all others are preserved 


The default setting is &10, and the minimum setting is &01; the number of retries can also be altered by 
poking &BE66 with the required value 


GET SECTOR DATA 
Gets the data of a sector on the current track 
E holds the drive number 


If a formatted disc is present, then Carry is true, and HL is preserved; if an unforrnatted disc is present or 
the disc is missing, then Carry is false, and HL holds the address of the byte before the status byte; in 
either case, A and the other flags are corrupt, and all other registers are preserved 


The track number is held at &BE4F, the head number is held at &BE50, the sector number is held at 
&BE51, and the log2(sector size)-7 is held at &BE52; disc parameters do not need to be set to the 
format of the disc; this routine is best used with the disc error messages turned off 
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&BCA7 SOUND RESET 

Action Resets the sound manager by clearing the sound queues and abandoning any current sounds 
Entry No entry conditions 

Exit AF, BC, DE and HL are corrupt, and all others are preserved 

&BCAA SOUND QUEUE 

Action Adds a sound to the sound queue of a channel 


HL contains the address of a series of bytes which define the sound and are stored in the central 32K of 


Entry RAM 


If the sound was successfully added to the queue, then Carry is true and HL is corrupt; if one of the 
Exit sound queues was full, then Carry is false and HL is preserved; in either case, A, BC, DE, IX and the 
other flags are corrupt, and all others are preserved 


The bytes required to define the sound are as follows 

byte 0 - channel status byte 

byte 1 - volume envelope to use 

byte 2 - tone envelope to use 

bytes 3&4 - tone period 

byte 5 - noise period 

byte 6 - start volume 

bytes 7&8 - duration of the sound, or envelope repeat count 


&BCAD SOUND CHECK 


Notes 


Action Gets the status of a sound channel 
Entry A contains the channel to test - for channel A, bit 0 set; for channel B, bit 1 set; for channel C, bit 2 set 
Exit A contains the channel status, BC, DE, HL and flags are corrupt, and all others are preserved 


The channel status returned is bit significant, as follows 
bits 0 to 2 - the number of free spaces in the sound queue 
bit 3 - trying to rendezvous with channel A 

Notes __ bit 4 - trying to rendezvous with channel B 
bit 5 - trying to rendezvous with channel C 
bit 6 - holding the channel 
bit 7 - producing a sound 


&BCBO SOUND ARM EVENT 
Action Sets up an event which will be activated when a space occurs in a sound queue 


A contains the channel to set the event up for (see SOUND CHECK for the bit values this can take), 
and HL holds the address of the event block 


Entry 
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved 

Notes The event block must be initialised by KL INIT EVENT and is disarmed when the event itself is run 
&BCB3 SOUND RELEASE 

Action Allows the playing of sounds on specific channels that had been stopped by SOUND HOLD 

Entry A contains the sound channels to be released (see SOUND CHECK for the bit values this can take) 
Exit AF, BC, DE, HL and IX are corrupt, and all others are preserved 

&BCB6 SOUND HOLD 

Action Immediately stops all sound output (on all channels) 

Entry No entry conditions 


If a sound was being made, then Carry is true; if no sound was being made, then Carry is false; in all 


a cases, A, BC, HL and other flags are corrupt, and all others are preserved 


Notes | When the sounds are restarted, they will begin from exactly the same place that they were stopped 


&BCB9 SOUND CONTINUE 
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Action Restarts all sound output (on all channels) 

Entry No entry conditions 

Exit AF, BC, DE and IX are corrupt, and all others are preserved 

&BCBC SOUND AMPL ENVELOPE 

Action Sets up avolume envelope 

Entry A holds an envelope number (from 1 to 15), HL holds the address of a block of data for the envelope 


If it was set up properly, Carry is true, HL holds the data block address + 16, A and BC are corrupt; if 
Exit the envelope number is invalid, then Carry is false, and A, B and HL are preserved; in either case, DE 
and the other flags are corrupt, and all other registers are preserved 


All the rules of enevelopes in BASIC also apply; the block of the data for the envelope is set up as 
follows 
byte 0 - number of sections in the envelope 
bytes 1 to 3 - first section of the envelope 
bytes 4 to 6 - second section of the envelope 
bytes 7 to 9 - third section of the envelope 
bytes 10 to 12 - fourth section of the envelope 
Notes bytes 13 to 15 - fifth section of the envelope 
Each section of the envelope has three bytes set out as follows 
byte 0 - step count (with bit 7 set) 
byte 1 - step size 
byte 2 - pause time or if it is a hardware envelope, then each section takes the following form 
byte 0 - envelope shape (with bit 7 not set) 
bytes 1 and 2 - envelope period 
See also SOUND TONE ENVELOPE below 


&BCBF SOUND TONE ENVELOPE 
Action Sets up a tone envelope 
Entry A holds an envelope number (from 1 to 15), HL holds the address of a block of data for the envelope 


If it was set up properly, Carry is true, HL holds the data block address + 16, A and BC are corrupt; ; if 
Exit the envelope number is invalid, then Carry is false, and A, B and HL are preserved; in either case, DE 
and the other flags are corrupt, and all other registers are preserved 


All the rules of envelopes in BASIC also apply; the block of the data for the envelope is set up as follows 
byte 0 - number of sections in the envelope 

bytes 1 to 3 - first section of the envelope 

bytes 4 to 6 - second section of the envelope 

bytes 7 to 9 - third section of the envelope 

bytes 10 to 12 - fourth section of the envelope 

bytes 13 to 15 - fifth section of the envelope 

Each section of the envelope has three bytes set out as follows 
byte 0 - step count 

byte 1 - step size 

byte 2 - pause time 

See also SOUND AMPL ENVELOPE above 


&BCC2 SOUND A ADDRESS 


Notes 


Action Gets the address of the data block associated with a volume envelope 
Entry A contains an envelope number (from 1 to 15) 


If it was found, then Carry is true, HL holds the data block's address, and BC holds its length; if the 
Exit envelope number is invalid, then Carry is false, HL is corrupt and BC is preserved; in both cases, A and 
the other flags are corrupt, and all others are preserved 


&BCC5 SOUND T ADDRESS 
Action Gets the address of the data block associated with a tone envelope 
Entry A contains an envelope number (from 1 to 15) 


If it was found, then Carry is true, HL holds the data block's address, and BC holds its length; if the 
Exit envelope number is invalid, then Carry is false, HL is corrupt and BC is preserved; in both cases, A and 
the other flags are corrupt, and all others are preserved 


70 The Amstrad CPC Firmware Guide 


The Machine Pack 


&BD13 
Action 
Entry 
Exit 


Notes 


&BD16 
Action 
Entry 
Exit 
&BD19 
Action 
Entry 
Exit 


Notes 


&BD1C 
Action 
Entry 
Exit 


Notes 


&BD1F 
Action 
Entry 
Exit 


Notes 


&BD22 
Action 
Entry 
Exit 


Notes 


&BD25 


Action 


MC BOOT PROGRAM 

Loads a program into RAM and then executes it 

HL contains the address of the routine which is used to load the program 
Control is handed over to the program and so the routine is not returned from 


All events, sounds and interrupts are turned off, the firmware indirections are returned to their default 
settings, and the stack is reset; the routine to run the program should be in the central block of memory, 
and should obey the following exit conditions: 

if the program was loaded successfully, then Carry is true, and HL contains the prograrn entry point; if 
the program failed to load, then Carry is false, and HL is corrupt; in either case, A, BC, DE, IX, lY and 
the other flags are all corrupt Should the program fail to load, control is returned to the previous 
foreground program 


MC START PROGRAM 

Runs a foreground program 

HL contains the entry point for the program, and C contains the ROM selection number 
Control is handed over to the prograrn and so the routine is not returned from 

MC WAIT FLYBACK 

Waits until a frame flyback occurs 

No entry conditions 

All registers are preserved 


When the frame flyback occurs the screen is not being written to and so the screen c~n be manipulated 
during this period without any flickering or ghosting on the screen 


MC SET MODE 

Sets the screen mode 

A contains the required mode 

AF is corrupt, and all other registers are preserved 


Although this routine changes the screen mode it does not inform the routines which write to the screen 
that the mode has been changed; therefore these routines will write to the screen as if the mode had not 
been changed; however as the hardware is now interpreting these signals differently, unusual effects 
may occur 


MC SCREEN OFFSET 

Sets the screen offset 

A contains the screen base, and HL contains the screen offset 
AF is corrupt, and all other registers are preserved 


As with MC SET MODE, this routine changes the hardware setting without telling the routines that write 
to the screen; therefore these routines may cause unpredictable effects if called; the default screen base 
is &CO 


MC CLEAR INKS 

Sets all the PENs and the border to one colour, so making it seem as if the screen has been cleared 
DE contains the address of the ink vector 

AF is corrupt, and all other registers are preserved 


The ink vector takes the following form: 

byte 0 - holds the colour for the border 

byte 1 - holds the colour for all of the PENs 

The values for the colours are all given as hardware values 


MC SET INKS 


Sets the colours of all the PENs and the border 
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DE contains the address of the ink vector 
AF is corrupt, and all other registers are preserved 


The ink vector takes the following form: 

byte 0 - holds the colour for the border 

byte 1 - holds the colour for PEN 0... byte 16 - holds the colour for PEN 15. The values for the colours 
are all given as hardware values; the routine sets all sixteen PEN's 


MC RESET PRINTER 

Sets the MC WAIT PRINTER indirection to its original routine 

No entry conditions 

AF, BC, DE and HL are corrupt, and all others are preserved 

MC PRINT CHAR 

Sends a character to the printer and detects if it is busy for too long (more than 0.4 seconds) 
A contains the character to be printed - only characters upto ASCII 127 can be printed 


If the character was sent properly, then Carry is true; if the printer was busy, then Carry is false; in either 
case, A and the other flags are corrupt, and all other registers are preserved 


This routine uses the MC WAIT PRINTER indirection 
MC BUSY PRINTER 

Tests to see if the printer is busy 

No entry conditions 


If the printer is busy, then Carry is true; if the printer is not busy, then Carry is false; in both cases, the 
other flags are corrupt, and all other registers are preserved 


MC SEND PRINTER 

Sends a character to the printer, which must not be busy 

A contains tlle character to be printed - only characters up to ASCII 127 can be printed 
Carry is true, A and the other flags are corrupt, and all other registers are preserved 
MC SOUND REGISTER 

Sends data to a sound chip register 

A contains the register nurnber, and C contains the data to be sent 

AF and BC are corrupt, and all other registers are preserved 

JUMP RESTORE 

Restores the jumpblock to its default state 

No entry conditions 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


This routine does not affect the indirections jumpblock, but restores all entries in the main jumpblock 
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KM SET LOCKS 

Turns the shift and caps locks on and off 

H contains the caps lock state, and L contains the shift lock state 
AF is corrupt, and all others are preserved 

In this routine, &00 means turned off, and &FF means turned on 
KM FLUSH 

Empties the key buffer 

No entry conditions 

AF is corrupt, and all other registers are preserved 

This routine also discards any current expansion string 

TXT ASK STATE 

Gets the VDU and cursor state 

No entry conditions 

A contains the VDU and cursor state, the flags are corrupt, and all others are preserved 


The value in the A register is bit significant, as follows: 

if bit 0 is set, then the cursor is disabled, otherwise it is enabled 
if bit 1 is set, then the cursor is turned off, otherwise it is on 

if bit 7 is set, then the VDU is enabled, otherwise it is disabled 


GRA DEFAULT 

Sets the graphics VDU to its default mode 

No entry conditions 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


Sets the background to opaque, the first point of line is plotted, lines aren't dotted, and the write mode is 
force 


GRA SET BACK 

Sets the graphics background mode to either opaque or transparent 

A holds zero if opaque mode is wanted, or holds &FF to select transparent mode 
All registers are preserved 

GRA SET FIRST 

Sets whether the first point of a line is plotted or not 

A holds zero if the first point is not to be plotted, or holds &FF if it is to be plotted 
All registers are preserved 

GRA SET LINE MASK 

Sets how the points in a line are plotted - ie defines whether a line is dotted or not 
A contains the line mask that will be used when drawing lines 

All registers are preserved 


The first point in the line corresponds to bit 7 of the line mask and after bit 0 the mask repeats; if a bit is 
set then that point will be plotted; the mask is always applied from left to right, or from bottom to top 


GRA FROM USER 
Converts user coordinates into base coordinates 
DE contains the user X coordinate, and HL contains the user Y coordinate 


DE holds the base X coordinate, and HL holds the base Y coordinate, AF is corrupt, and all others are 
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preserved 
GRA FILL 


Fills an area of the screen starting from the current graphics position and extending until it reaches 
either the edge of the window or a pixel set to the PEN 


A holds a PEN to fill with, HL holds the address of the buffer, and DE holds the length of the buffer 


If the area was filled properly, then Carry is true; if the area was not filled, then Carry is false; in either 
case, A, BC, DE, HL and the other flags are corrupt, and all others are preserved 


The buffer is used to store complex areas to fill, which are remembered and filled when the basic shape 
has been done; each entry in the buffer uses seven bytes and so the more complex the shape the larger 
the buffer; if it runs out of space to store these complex areas, it will fill what it can and then return with 
Carry false 


SCR SET POSITION 
Sets the screen base and offset without telling the hardware 
A contains the screen base, and HL contains the screen offset 


A contains the masked screen base, and HL contains the masked screen offset, the flags are corrupt, 
and all other registers are preserved 


MC PRINT TRANSLATION 
Sets how ASCII characters will be translated before being sent to the printer 
HL contains the address of the table 


If the table is too long, then Carry is false (ie more than 20 entries); if the table is correctly set out, then 
Carry is true; in either case, A, BC, DE, HL and the other flags are corrupt, and all others are preserved 


The first byte in the table is the number of entries; each entry requires two bytes, as follows: 
byte 0 - the character to be translated byte 1 - the character that is to be sent to the printer If the 
character to be sent to the printer is &FF, then the character is ignored and nothing is sent 


KL BANK SWITCH (6128 only) 
Sets which RAM banks are being accessed by the Z80 
A contains the organisation that is to be used 


A contains the previous organisation, the flags are corrupt, and all other registers are preserved 
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Notes 
&BDE2 


Action 


TXT DRAW CURSOR 

Places the cursor on the screen, if the cursor is enabled 

No entry conditions 

AF is corrupt, and all other registers are preserved 

The cursor is an inverse blob which appears at the current text position 
TXT UNDRAW CURSOR 

Removes the cursor from the screen, if the cursor is enabled 
No entry conditions 

AF is corrupt, and all the other registers are preserved 

TXT WRITE CHAR 

Writes a character onto the screen 


A holds the character to be wntten, H holds the physical column number, and L holds the physical line 
number 


AF, BC, DE and HL are corrupt, and all other registers are preserved 

TXT UNWRITE 

Reads a character from the screen 

H contains the physical column number, and L contains the physical line number to read from 


If a character was found, then Carry is true, and A contains the character; if no character was found, 
then Carry is false, and A contains zero; in either case, BC, DE, HL and the other nags are corrupt, and 
all other registers are preserved 


This routine works by comparing the image on the screen with the character matrices; therefore if the 
character matrices have been altered the routine may not find a readable a character 


TXT OUT ACTION 

Writes a character to the screen or obeys a control code (&00 to &1F) 
A contains the character or code 

AF, BC, DE and HL are corrupt, and all other registers are preserved 


Control codes may take a maximum of nine parameters; when a control code is found, the required 
number of parameters is read into the control code buffer, and then the control code is acted upon; if 
the graphics character wnte mode is enabled, then characters and codes are printed using the graphics 
VDU; when using the graphics VDU control codes are printed and not obeyed 


GRA PLOT 

Plots a point in the current graphics PEN 

DE contains the user X coordinate, and HL contains the user Y coordinate of the point 
AF, BC, DE and HL are corrupt, and all other registers are preserved 

This routine uses the SCR WRITE indirection to write the point to the screen 

GRA TEST 

Tests a point and finds out what PEN it is set to 

DE contains the user X coordinate, and HL contains the user Y coordinate of the point 
A contains the PEN that the point is written in, BC, DE and HL are corrupt, and all others are preserved 
This routine uses the SCR READ indirection to test a point on the screen 

GRA LINE 


Draws a line in the current graphics PEN, from the current graphics position to the specified point 
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&BDF1 
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DE contains the user X coordinate, and HL contains the user Y coordinate for the endpoint 
AF, BC, DE and HL are corrupt, and all others are preserved 

This routine uses the SCR WRITE indirection to write the points of the line on the screen 
SCR READ 

Reads a pixel from the screen and returns its decode a PEN 

HL contains the screen address of the pixel, and C contains the mask for the pixel 

A contains the decoded PEN of the pixel, the flags are corrupt, and all others are preserved 
The mask should be for a single pixel, and is dependent on the screen mode 

SCR WRITE 

Writes one or more pixels to the screen 

HL contains the screen address of the pixel, C contains the mask, and B contains the encoded PEN 
AF is corrupt, and all other registers are preserved 

The mask should determine which pixels in the screen byte are to be plotted 

SCR MODE CLEAR 

Fills the entire screen memory with &00, which clears the screen to PEN 0 

No entry conditions 

AF, BC, DE and HL are corrupt, and all the other registers are preserved 

KM TEST BREAK 

Tests if the ESC key has been pressed, and acts accordingly 

C contains the Shift and Control key states, and interrupts must be disabled 

AF and HL are corrupt, and all other registers are preserved 


If bit 7 of C is set, then the Control key is pressed; if bit 5 of C is set, then the Shift key is pressed; if 
ESC, Shift and Control are pressed at the sarne time, then it initiates a system reset; otherwise it 
reports a break event 


MC WAIT PRINTER 
Sends a character to the printer if it is not busy 
A contains the character to be sent to the printer 


If the character was printed successfully, then Carry is true; if the printer was busy for too long (more 
than 0.4 seconds), then Carry is false; in either case, A and BC are corrupt, and all other registers are 
preserved 


KM SCAN KEYS 
Scans the keyboard every 1/50th of a second, and updates the status of all keys 
All interrupts must be disabled 


AF, BC, DE and HL are corrupt, and all other registers are preserved 
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&BD64 
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&BD6A 
Action 


Entry 


Exit 


Notes 
&BD6D 
Action 
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Notes 


&BD70 
Action 
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Exit 


Notes 
&BD73 
Action 


Entry 
Exit 


MOVE REAL (&BD3D for the 464) 
Copies the five bytes that are pointed to by DE to the location held in HL 
DE points to the source real value, and HL points to the destination 


HL points to the real value in the destination, Carry is true if the move went properly, F is corrupt, and all 
other registers are preserved 


For the 464 only, A holds the exponent byte of the real value when the routine is exited 
INTEGER TO REAL (&BD40 for the 464) 
Converts an integer value into a real value 


HL holds the integer value, DE points to the desti- nation for the real value, bit 7 of A holds the sign of 
the integer value - it is taken to be negative if bit 7 is set 


HL points to the real value in the destination, AF and DE are corrupt, and all others are preserved 
BINARY TO REAL (&BD43 for the 464) 

Converts a four byte binary value into a real value at the same location 

HL points to the binary value, bit 7 of A holds the sign of the binary value - negative if it is set 


HL points to the real value in lieu of the four byte binary value, AF is corrupt, and all others are 
preserved 


A four byte binary value is an unsigned integer up to &FFFFFFFF and is stored with the least significant 
byte first, and with the most significant byte last 


REAL TO INTEGER (&BD46 for the 464) 
Converts a real value, rounding it into an unsigned integer value held in HL 
HL points to the real value 


HL holds the integer value, Carry is true if the conversion worked successfully, the Sign flag holds the 
sign of the integer (negative if it is set). A, IX and the other flags are corrupt, and all other registers are 
preserved 


This rounds the decimal part down if it is less than 0.5, but rounds up if it is greater than, or equal to 0.5 
REAL TO BINARY (&BD49 for the 464) 

Converts a real value, rounding it into a four byte binary value at the same location 

HL points to the real value 


HL points to the binary value in lieu of the real value, bit 7 of B holds the sign for the binary value (it is 
negative if bit 7 is set), AF, B and IX are corrupt, and all other registers are preserved 


See REAL TO INTEGER for details of how the values are rounded up or down 
REAL FIX (&BD4C for the 464) 


Performs an equivalent of BASIC's FIX function on a real value, leaving the result as a four byte binary 
value at the same location 


HL points to the real value 


HL points to the binary value in lieu of the real value, bit 7 of B has the sign of the binary value (it is 
negative if bit 7 is set), AF, B and IX are corrupt, and all others are preserved 


FIX removes any decimal part of the value, rounding down whether positive or negative - see the 
BASIC handbook for more details on the FIX command 


REAL INT (&BD4F for the 464) 


Performs an equivalent of BASIC's INT function on a real value, leaving the result as a four byte binary 
value at the same location 


HL points to the real value 


HL points to the binary value in lieu of the real value, bit 7 of B has the sign of the binary value (it is 
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negative if bit 7 is set), AF, B and IX are corrupt, and all others are preserved 


INT removes any decimal part of the value, rounding down if the nurnber is positive, but rounding up if it 
is negative 


INTERNAL SUBROUTINE - not useful (&BD52 for the 464) 
REAL *10“A (&BD55 for the 464) 


Multiplies a real value by 10 to the power of the value in the A register, leaving the result at the same 
location 


HL points to the real value, and A holds the power of 10 

HL points to the result, AF, BC, DE, IX and IY are corrupt 

REAL ADDITION (&BD58 for the 464) 

Adds two real values, and leaves the result in lieu of the first real number 

HL points to the first real value, and DE points to the second real value 

HL points to the result, AF, BC, DE, IX and lY are corrupt 

REAL REVERSE SUBTRACTION (&BD5E for the 464) 

Subtracts the first real value from the second real value, and leaves the result in lieu of the first number 
HL points to the first real value, and DE points to the second real value 

HL points to the result in place of the first real value, AF, BC, DE, IX and IY are corrupt 
REAL MULTIPLICATION (&BD61 for the 464) 

Multiplies two real values together, and leaves the result in lieu of the first number 

HL points to the first real value, and DE points to the second real value 

HL points to the result in place of the first real value, AF, BC, DE, IX and IY are corrupt 
REAL DIVISION (&BD64 for the 464) 

Divides the first real value by the second real value, and leaves the result in lieu of the first number 
HL points to the first real value, and DE points to the second real value 

HL points to the result in place of the first real value, AF, BC, DE, IX and IY are corrupt 
REAL COMPARISON (&BD6A for the 464) 

Compares two real values 

HL points to the first real value, and DE points to the second real value 


A holds the result of the comparison process, IX, lY, and the other flags are corrupt, and all others are 
preserved 


After this routine has been called, the value in A depends on the result of the comparison as follows 
if the first real number is greater than the second real number, then A holds &01 
if the first real number is the same as the second real number, then A holds &00 
if the second real number is greater than the first real number, then A holds &FF 


REAL UNARY MINUS (&BD6D for the 464) 
Reverses the sign of a real value 
HL points to the real value 


HL points to the new value of the real number (which is stored in place of the original number), bit 7 of A 
holds the sign of the result (it is negative if bit 7 is set), AF and IX are corrupt, and all other registers are 
preserved 


REAL SIGNUM/SGN (&BD70 for the 464) 
Tests a real value, and compares it with zero 
HL points to the real value 


A holds the result of this comparison process, IX and the other jlags are corrupt, and all others are 
preserved 


After this routine has been called, the value in A depends on the result of the comparison as follows 
if the real number is greater than 0, then A holds &01, Carry is false, and Zero is false 
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if the real number is the same as 0, then A holds &00, Carry is false, and Zero is true 
if the real number is smaller than 0, then A holds &FF, Carry is true, and Zero is false 


SET ANGLE MODE (&BD73 for the 464) 

Sets the angular calculation mode to either degrees (DEG) or radians (RAD) 
A holds the mode setting - 0 for RAD, and any other value for DEG 

All registers are preserved 

REAL PI (&BD76 for the 464) 

Places the real value of pi at a given memory location 

HL holds the address at which the value of pi is to be placed 

AF and DE are corrupt, and all other registers are preserved 

REAL SQR (&BD79 for the 464) 

Calculates the square root of a real value, leaving the result in lieu of the real value 
HL points to the real value 

HL points to the result of the calculation, AF, BC, DE, IX and IY are corrupt 
REAL POWER (&BD7C for the 464) 


Raises the first real value to the power of the second real value, leaving the result in lieu of the jirst real 


value 

HL points to the first real value, and DE points to the second real value 

HL points to the result of the calculation, AF, BC, DE, IX and IY are corrupt 
REAL LOG (&BD7F for the 464) 


Returns the naperian logarithm (to base e) of a real value, leaving the result in lieu of the real value 


HL points to the real value 

HL points to the logarithrn that has been calculated, AF, BC, DE, LY and IY are corrupt 
REAL LOG 10 (&BD82 for the 464) 

Returns the logarithm (to base 10) of a real value, leaving the result in lieu of the real value 
HL points to the real value 

HL points to the logarithrn that has been calculated, AF, BC, DE, IX and IY are corrupt 
REAL EXP (&BD85 for the 464) 

Returns the antilogarithm (base e) of a real value, leaving the result in lieu of the real value 
HL points to the real value 

HL points to the antilogarithm that has been cal- culated, AF, BC, DE, IX and IY are corrupt 
See the BASIC handbook for details of EXP 

REAL SINE (&BD88 for the 464) 

Returns the sine of a real value, leaving the result in lieu of the real value 

HL points to the real value (ie all angle) 

HL points to the sine value that has been calculated, AF, BC, DE, IX and IY are corrupt 
REAL COSINE (&BD8B for the 464) 

Returns the cosine of a real value, leaving a the result in lieu of the real value 

HL points to the real value (ie an angle) 

HL points to the cosine value that has been calculated, AF, BC, DE, IX and IY are corrupt 
REAL TANGENT (&BD8E for the 464) 

Returns the tangent of a real value, leaving the result in lieu of the real value 


HL points to the real value (ie an angle) 
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HL points to the tangent value that has been cal- culated, AF, BC, DE, IX and IY are corrupt 
REAL ARCTANGENT (&BD91 for the 464) 

Returns the arctangent of a real value, leaving the result in lieu of the real value 

HL points to the real value (ie an angle) 


HL points to the arctangent value that has been calculated, AF, BC, DE, IX and IY are corrupt All of the 
above routines to calculate sine, cosine, tangent and arctangent are slightly inaccuarate 


INTERNAL SUBROUTINE - not useful (&BD94 for the 464) 
INTERNAL SUBROUTINE - not useful (&BD97 for the 464) 
INTERNAL SUBROUTINE - not useful (&BD9A for the 464) 
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REAL SUBTRACTION 

Subtracts the second real value from the first real value, and leaves the result in lieu of the first number 
HL points to the first real value, and DE points to the second real value 

HL points to the result in place of the first real value, AF, BC, DE, IX and IY are corrupt 

REAL EXPONENT ADDITION 

Adds the value of the A register to the exponent byte of a real number 

HL points to the real value, and A holds the value to he added 

HL points to the result in place of the first real value, AF and IX are corrupt, and all others are preserved 
INTERNAL SUBROUTINE - not useful 

INTERNAL SUBROUTINE - not useful 

INTERNAL SUBROUTINE - not useful 

INTERNAL SUBROUTINE - not useful 

INTERNAL SUBROUTINE - not useful 

INTEGER ADDITION 

Adds two signed integer values 

HL holds the first integer value, and DE holds the second integer value 


HL holds the result of the addition, A holds &FF if there is an overflow but is preserved otherwise, the 
flags Z are corrupt, and all other registers are preserved 


INTEGER SUBTRACTION 
Subtracts the second signed integer value from the first signed integer value 
HL holds the first integer value, and DE holds the second integer value 


HL holds the result of the subtraction, A holds &FF if there is an overflow but is preserved othenvise, the 
flags are corrupt, and all the other registers are preserved 


INTEGER REVERSE SUBTRACTION 

Subtracts the first signed integer value from the second signed integer value 

HL holds the first integer value, and DE holds the second integer value 

HL holds the result of the subtraction, AF and DE are corrupt, and all others are preserved 
INTEGER MULTIPLICATION 

Multiplies two signed integer values together, and leaves the result in lieu of the first number 
HL holds the first integer value, and DE holds the second integer value 


HL holds the result of the multiplication, A holds &FF if there is an overflow but is corrupted otherwise, 
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the flags, BC and DE are corrupt, and the other registers are preserved 

Multiplication of signed integers does not produce the sarne result as with unsigned integers 
INTEGER DIVISION 

Divides the first signed integer value by the second signed integer value 

HL holds the first integer value, and DE holds the second integer value 


HL holds the result of the division, DE holds the remainder, AF and BC are corrupt, and all others are 
preserved 


Division of signed integers does not produce the same result as with unsigned integers 
INTEGER DIVISION 2 

Divides the first signed integer value by the second signed integer value 

HL holds the first integer value, and DE holds the second integer value 


DE holds the result of the division, HL holds the remainder, AF and BC are corrupt, and all others are 
preserved 


Division of signed integers does not produce the same result as with unsigned integers 
INTERNAL SUBROUTINE - not useful 

INTERNAL SUBROUTINE - not useful 

INTEGER COMPARISON 

Compares two signed integer values 

HL holds the first integer value, and DE holds the second integer value 

A holds the result of the comparison process, the flags are corrupt, and all others are preserved 


After this routine has been called, the value in A depends on the result of the comparison as follows 

if the first real number is greater than the second real number, then A holds &01 

if the first real number is the same as the second real number, then A holds &00 

if the second real number is greater than the first real number, then A holds &FF 

With signed integers, the range of values runs from &8000 (-32768) via zero to &/7FFF (+32767) and so 
any value which is greater than &8000 is considered as being less than a value of &7FFF or less 


INTEGER UNARY MINUS 

Reverses the sign of an integer value (by subtracting it from &10000) 

HL holds the integer value 

HL holds the new value of the integer number, AF is corrupt, cmd all other registers are preserved 
INTEGER SIGNUM/SGN 

Tests a signed integer value 

HL holds the integer value 

A holds the result of this comparison process, the flags are corrupt, and all others are preserved 


After this routine has been called, the value in A depends on the result of the comparison as follows 
if the integer number is greater than 0 and is less than &8000, then A holds &01 

if the integer number is the same as 0, then A holds &00 

if the integer number is greater than &7FFF and less than or equal to &FFFF, then A holds &FF 
See INTEGER COMPARISON for more details on the way that signed integers are laid out 


Maths Subroutines for the 664 and 6128 only 
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TEXT INPUT 


Allows upto 255 characters to be input from the keyboard into a buffer (hmmm ... not really a maths 
routine ...) 


HL points to the start of the buffer - a NUL character must be placed after any characters already 
present, or at the start of the buffer if there is no text 
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A has the last key pressed, HL points to the start of the buffer, the flags are corrupt, and all others are 
preserved 


This routine prints any existing contents of the buffer (upto the NUL character) and then echoes any 
keys used; it allows full line editing with the cursor keys and DEL, etc; it is exited only by use of ENTER 
or ESC 


REAL RND 

Creates a new RND real value at a location pointed to by HL 

HL points to the destination for the result 

HL points to the RND value, AF, BC, DE and IX registers are corrupt; and all others are preserved 
REAL RND(0) 

Returns the last RND value created, and puts it in a location pointed to by HL 

HL points to the place where the value is to be returned to 

HL points to the value created, AF, DE and IX are corrupt, and all other registers are preserved 


See the BASIC handbook for more details on RND(0) 
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The Z80 Instruction Set 


The lists contains all the normal machine code instructions for the microprocessor, plus a number of 
undocumented ones. The latter comprise those which operate on the high or low bytes of the Index 
registets (IX and IY) which are notated here as HIX, LIX, HIY and LIY - some assemblers may use the 
form IXH, etc - and a set of rotation instructions complementary to SRL, which are designated SLL. 


The Opcodes and T states 


Within the tables of instructions, a number of abbreviations are used: 


in| [asingle byte value (from 0(&00)to255(&FF)) 
fadar| [an address value (from 0 (80000) to 65535 (@FFFF))=SOS*~*S 


(in the sequence of opcode bytes, ‘addr' and ‘hilo' are entered low byte first) 


The next two columns detail the number of bytes applicable to each instruction, and the number of T 
states (clock pulses) that each requires - some have two figures which are distinguised as follows: 


f means ‘the number of T states required when the condition is false’ 

t means ‘the number of T states needed when the condition is true’ 

= means ‘the number of T states needed when either BC=0 and/or A matches the contents of HL' 
# means ‘the number of T states required when both the above conditions are false’ 

Z means ‘the number of T states needed when B=0' 


nz means ‘the number of T states requrred when B<>0' 


The Flag Register 
The last columns give the effect on the flag bits which each instruction causes: 


? means the setting of the bit is unpredictable 

- means the setting of the bit is unchanged 

0 means that the flag bit is reset to zero 

1 means that the flag bit is set to one. 

In addition, the Sign flag (bit 7) is also set: 

7 if bit 7 of the A register is set 

15 if bit 15 of the HL register pair (ie bit 7 of the H register) is set 
=7 _ if bit 7 of the A register would be set by subtraction in lieu of CP 
The Zero flag (bi6 6) is also set: 

Z if the A register or the HL register pair equals zero 

= if the A register matches the compared register or value 


=A __ if the A register matches the contents of the address pointed to by HL 
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<>B 


<>b 


if the B register holds zero 


if the bit tested is zero 


The Parity/Overflow flag (bit 2) is also set: 


p 


A80 


if the register concemed contains an even number of set bits 
if an overflow has occured in Two's Complement arithmetic 

if BC is not zero 

if the A register was &80 before this instruction was performed 


to the contents of the microprocessor's internal interrupt register 


The Carry flag (bit 0) is also set: 


if an addition resulted in a carry out of bit 7 (for a register) or bit 15 (for a register pair) 
if a subtraction required a borrow from bit 7 (for a register) or bit 15 (for a register pair) 
if the A register is less than the value or register that is being compared 

by the bit rotated in from bit 0 of the register concerned 

by the bit rotated in from bit 7 of the register concerned 

if the Carry was reset (ie zero) before this instruction was performed 


if tbe A register was &00 before this instruction was performed 


The flag register is bit significant, and the bits are defined as follows: 
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7 - Sign 


6 - Zero 

5 - unused 

4 - Half Carry (cannot test) 

3 - unused 

2 - Parity/Overflow 

1 - Add/Subtract (cannot test) 


0 - Carry 


Instruction Opcode B Ts Ss Zz P Cc 
BIT 0,(HL) CB 46 2 12 ? <>b ? - 
BIT 0,(IX+d) CBDD46d 4 20 ? <>b ? - 
BIT 0,(IY+d) CBFD46d 4 20 ? <>b ? - 
BIT 0,A CB 47 2 8 ? <>b ? 2 
BIT 0,B CB 40 2 8 ? <>b ? . 
BIT 0,C CB 41 2 8 ? <>b ? 2 
BIT 0,D CB 42 2 8 ? <>b ? 7 
BIT 0,E CB 43 2 8 ? <>b ? - 
BIT 0,H CB 44 2 8 ? <>b ? - 
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Instruction 
BIT 0,L 
BIT 1,(HL) 
BIT 1,(IX+d) 
BIT 1,(IY+d) 
BIT 1,A 
BIT 1,B 

BIT 1,C 
BIT 1,D 
BIT 1,E 
BIT 1,H 
BIT 1,L 

BIT 2,(HL) 
BIT 2,(IY+d) 
BIT 2,(LY+d) 
BIT 2,A 
BIT 2,B 

BIT 2,C 
BIT 2,D 
BIT 2,E 
BIT 2,H 
BIT 2,L 

BIT 3,(HL) 
BIT 3,(IX+d) 
BIT 3,(IY+d) 
BIT 3,A 
BIT 3,B 
BIT 3,C 
BIT 3,D 
BIT 3,E 

BIT 3,H 
BIT 3,L 

BIT 4,(HL) 
BIT 4,(IY+d) 
BIT 4,(LY+d) 
BIT 4,A 
BIT 4,B 
BIT 4,C 
BIT 4,D 
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Opcode 
CB 45 
CB 4E 
CB DD 4Ed 
CB FD 4Ed 
CB 1F 
CB 48 
CB 49 
CB 4A 
CB 4B 
CB 4C 
CB 4D 
CB 56 
CB FD 56d 
CB DD 56 d 
CB 57 
CB 50 
CB 51 
CB 52 
CB 53 
CB 54 
CB 55 
CB 5E 
CB DD 5E d 
CB FD 5Ed 
CB 5F 
CB 58 
CB 59 
CB 5A 
CB 5B 
CB 5C 
CB 5D 
CB 66 
CB FD 66d 
CB DD 66 d 
CB 67 
CB 60 
CB 61 
CB 62 


85 


Instruction Opcode 


BIT 4,E CB 63 
BIT 4,H CB 64 
BIT 4,L CB 65 


BIT5,(HL)  CB6E 
BIT 5,(IX+d) CBDD6Ed 
BIT 5,(IY+d) CBFD6Ed 


BIT 5,A CB 6F 
BIT 5,B CB 68 
BIT 5,C CB 69 
BIT 5,D CB 6A 
BIT 5,E CB 6B 
BIT 5,H CB 6C 
BIT 5,L CB 6D 


BIT6,(HL)  CB76 
BIT 6,(IX+d) CBDD 76d 
BIT 6,(IY+d) CBFD76d 


BIT 6,A CB 77 
BIT 6,B CB 70 
BIT 6,C CB 71 
BIT 6,D CB 72 
BIT 6,E CB 73 
BIT 6,H CB 74 
BIT 6,L CB 75 


BIT 7,(HL)  CB7E 
BIT 7,(IX+d) CBDD7Ed 
BIT 7,(IY+d) CBFD7Ed 


BIT 7,A CB 7F 
BIT 7,B CB 78 
BIT 7,C CB 79 
BIT 7,D CB 7A 
BIT 7,E CB 7B 
BIT 7,H CB 7C 
BIT 7,L CB 7D 


CALL addr CD dr ad 
CALL c,addr DC drad 
CALL m,addr FC drad 
CALL nc,addr D4 dr ad 
CALL nz,addr C4 dr ad 


86 The Amstrad CPC Firmware Guide 


t17f10 
t17f10 
t17f10 
t17f10 


Instruction 
CALL p,addr 
CALL po,addr 
CALL pe,addr 
CALL z,addr 
CCF 
CP (HL) 

CP (IX+d) 
CP (IY+d) 
CPA 

CP B 
CPC 

CP D 
CPE 

CP H 

CP HIX 
CP HIY 
CPL 

CP LIX 
CP LIY 
CP n 
CPD 
CPDR 
CPI 

CPIR 
CPL 

DAA 
DEC (HL) 
DEC (IX+d) 
DEC (lY+d) 
DEC A 
DEC B 
DEC BC 
DEC C 
DEC D 
DEC DE 
DEC E 
DEC H 
DEC HIX 


Opcode 


F4 dr ad 
E4 dr ad 
EC dr ad 
CC dr ad 
3F 

BE 

DD BE d 
FD BEd 
BF 

B8 

B9 

BA 

BB 

BC 

DD BC 
FD BC 
BD 

DD BD 
FD BD 
FEn 
ED AQ 
ED B9 
ED A1 
ED B2 
2F 

27 

35 

DD 35d 
FD 35d 
3D 

05 

0B 

OD 

15 

1B 

1D 

25 

DD 25 


MP DMO NO NBO YB NO ND 


Ts 
t17f10 
t17f10 
t17f10 
t17f10 
4 


rs 
Oo Oo 


N © Oo FRO Oo FP FH HK HR HP A 


opr FDO KR FH DO HR F 
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87 


88 


Instruction 
DEC HIY 
DEC HL 
DEC IX 
DEC IY 
DEC L 
DEC LIX 
DEC LIY 
DEC SP 
DI 
DJNZ d 

El 

EX (SP),HL 
EX (SP),IX 
EX (SP),IY 
EX AF,AF' 
EX DE,HL 
EXX 
HALT 
IMO 

IM 1 

IM 2 

IN A,(C) 
IN A,(n) 
IN B,(C) 
IN C,(C) 
IN D,(C) 
IN E,(C) 
IN H,(C) 
IN L,(C) 
INC (HL) 
INC (IX+d) 
INC (IY+d) 
INCA 
INC B 
INC BC 
INC C 
INC D 
INC DE 


Opcode 
FD 25 


ED 46 
ED 56 
ED 5E 
ED 78 
DBn 
ED 40 
ED 48 
ED 50 
ED 58 
ED 60 
ED 68 
34 

DD 34d 
FD 34d 
3C 

04 

03 

le 

14 

13 


NO ND 


NO N 


MPO MO MO NBO NBO NB NBO YB YP NM ND 


= 


Ts 


“N 


NN NN NNNNN NN 
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Instruction 
INC E 
INC H 
INC HIX 
INC HIY 
INC HL 
INC IX 
INC IY 
INC L 
INC LIX 
INC LIY 
INC SP 
IND 
INDR 
INI 
INIR 
JP (HL) 
JP (IX) 
JP (IY) 
JP addr 
JP c,addr 
JP m,addr 
JP nc,addr 
JP nz,addr 
JP p,addr 
JP po,addr 
JP pe,addr 
JP z,addr 
JR c,d 
JRd 
JR nc,d 
JR nz,d 
JR z,d 
LD (addr) 
LD (addr) 
LD (addr) 
LD (addr) 
LD (addr) 

) 


A 
BC 
,DE 
JHL 
JHL 
LD (addr),IX 
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Opcode 
1C 


E9 

DD E9 

FD E9 

C3 dr ad 
DA dr ad 
FA dr ad 
D2 dr ad 
C2 dr ad 

F2 dr ad 

E2 dr ad 
EA dr ad 
CA dr ad 
38 d 

18d 

30d 

20d 

28d 

32 dr ad 
ED 43 dr ad 
ED 53 dr ad 
22 dr ad 
ED 63 dr ad 
DD 22 dr ad 


B FB wo fF BP WY NY NY NY YB Ww Ww Ww WwW Ww Ww WwW Ww WwW DN KN 


6 

16 
z16nz21 
16 
z16nz21 
4 


t12f7 


t12f7 
t12f7 
t12f7 
13 
20 
20 
16 
20 
20 


N NNN 


89 


90 


Instruction 
LD (addr), IY 
LD (addr),SP 


LD (IX+d),A 
LD (IX+d),B 
LD (IX+d),C 
LD (IX+d),D 
LD (IX+d),E 
LD (IX+d),H 
LD (IX+d),L 
LD (IX+d), 
LD (IY+d), 
LD (IY+d), 
LD (IY+d), 
LD (IY+d), 
LD (IY+d), 
LD (IY+d), 
LD (IY+d), 
LD (lY+d),n 
LD A,(addr) 
LD A,(BC) 
LD A,(DE) 
LD A,(HL 
LD A,(HL 
LD A,(IX+d) 
LD A,(IY+d) 
LDA,A 

LD A,B 


n 
A 
B 
CG 
D 
E 
H 
L 


) 
) 
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Opcode 
FD 22 dr ad 
ED 73 dr ad 
02 
12 
77 
77 
70 
71 
72 
73 
74 
75 
36n 
DD 77d 
DD 70d 
DD 71d 
DD 72d 
DD 73d 
DD 71d 
DD 75d 
DD 36 dn 
FD 77d 
FD 70d 
FD 71d 
FD 72d 
FD 73d 
FD 74d 
FD 75d 
FD 36dn 
3A dr ad 
OA 
1A 


NO ND 
Oo oO 


NN WN NNW NNN 


at) Sk ky ae pei a a Ge a a a es cea eh 
on © © © O© © © O© OO © © © O© O© O© O O OD 


19 
19 


+ 
7) 


Instruction Opcode B Ts Ss Zz 


LD A,C 
LD A,D 
LD AE 
LD AH 
LD A,HIX 
LD A,HIY 
LDA 
LD AL 
LD A,LIX 
LD A,LIY 
LD A,n 
LD A,R 
LD B,(HL) 


LD B,IX+d) DD 46d 


LD B,A 
LD B,B 
LD B,C 
LD B,D 
LD B,E 
LD B,H 
LD B,HIX 
LD B,HIY 
LD B,L 
LD B,LIX 
LD B,LIY 
LD B,n 


LD BC,hilo 
LD C,(HL) 


LD C(IY+d) DD4Ed 


LD C,A 
LD C,B 
LD C,C 
LD C,D 
LD C,E 
LD C,H 


79 fA a, fet: 1 
7A 14 a 2 
7B 14 4 et 
7C 14 a eS 
DD 7C 2 8 a he, tg 
FD 7C 2 8 SS et 
ED 57 29 7% 2. ii 
7D 14 a ee 
DD 7D 2 8 boo” «s 
FD 7D 2 8 2 eR # 
3E n Ee ce eee 
ED 5F oy is a 
46 4°7 oe ae 

3 19 Bie ee we 

LD B/(IY+d) FD 46d 3 19 ee ae 
47 14 et we 
40 14 re eee 
A 14 sS .2 2 
42 14 a e- 3e 
43 14 a ca? 2 
44 14 a. ok 
DD 44 2 8 e. ok “ue 
FD 44 2 8 eo ae, US 
45 14 sw 
DD 45 a8 oe ee 
FD 45 2 8 Be ty & 
06 n oF ae ne 

LD BC(addr) ED4Bdrad 4 20 g «me: 14 
01 lo hi 3 10 a ae 
4E 1 7 . = & 

LD C,IX+d) DD4Ed 3 19 a. 23° 4 

3 19 a. ee 
4F 1-4 o gs ss 
48 14 2. 2 
49 i 4 yy Be 
4A 11 a, tS 
4B 14 a 
4C 14 ee ty ae 
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92 


Instruction Opcode 


LD C,HIX 
LD C,HIY 
LD C,L 

LD C,LIX 
LD C,LIY 
LD C,n 

LD D,(HL) 


LD D,(IX+d) DD56d 
LD D(IY+d) FD56d 


LD D,A 
LD D,B 
LD D,C 
LD D,D 
LD D,E 
LD D,H 
LD D,HIX 
LD D,HIY 
LD D,L 
LD D,LIX 
LD D,LIY 
LD D,n 


LD DE,hilo 
LD E,(HL) 


LDE/(IY+d) FD5Ed 


LDE,A 
LD E,B 
LD E,C 
LD E,D 
LD E,E 
LD E,H 
LD E,HIX 
LD E,HIY 
LD E,L 
LD E,LIX 
LD E,LIY 
LD E,n 


B Ts Ss Zz 
DD 4C 2 8 - 7 
FD 4C 2 8 - - = 
4D 1 4 - - - 
DD 4D 2 8 - 7 e 
FD 4D 2 8 - 7 : 
OEn 2 7 - - = 
56 1 7 - é = 
3 19 - - = 
3 19 - - - 
57 1 4 - 7 - 
50 1 4 - - = 
51 1 4 - - = 
52 1 4 - 7 
53 1 4 - - < 
54 1 4 - - 
DD 54 2 8 - - 2 
FD 54 2 8 - - 2 
55 1 4 - - = 
DD 55 2 8 - - = 
FD 55 2 8 - - 2 
16n 27 - - - 
LD DE,(addr) ED5Bdrad 4 20 = - - 
11 lo hi 3 10 - - * 
5E 1 7 - - = 
LDE,(IX+td) DD5Ed 3 19 - 7 2 
3 19 - 7 
SF 1 4 - 7 i 
58 1 4 - 7 2 
59 1 4 - - = 
5A 1 4 - = = 
5B 1 4 - 7 2 
5C 1 4 - 7 - 
DD 5C 2 8 - 7 = 
FD 5C 2 8 - - 
5D 1 4 - - = 
DD 5D 2 8 - - Fe 
FD 5D 2 8 - 7 e 
1E)n 27 - 7 he 
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Instruction 
LD H,(HL) 
LD H,(IX+d) 
LD H,(lY+d) 
LD H,A 

LD H,B 

LD H,C 

LD H,D 

LD H,E 

LD H,H 

LD H,L 

LD H,n 

LD HIX,A 
LD HIX,B 
LD HIX,C 
LD HIX,D 
LD HIX,E 
LD HIX,HIX 
LD HIX,LIX 
LD HIX,n 
LD HIY,A 
LD HIY,B 
LD HIY,C 
LD HIY,D 
LD HIY,E 
LD HIY,HIY 
LD HIY,LIY 
LD HIY,n 
LD HL,(addr) 
LD HL,(addr) 
LD HL,hilo 
LDLA 

LD IX,(addr) 
LD IX,hilo 
LD IY,(addr) 
LD IY,hilo 
LD L,(HL) 
LD L,(IX+d) 
LD L,(IY+d) 
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Opcode 
66 
DD 66 d 
FD 66d 


65 

26n 

DD 67 

DD 60 

DD 61 

DD 62 

DD 63 

DD 64 

DD 65 

DD 26 n 
FD 67 

FD 60 

FD 61 

FD 62 

FD 63 

FD 64 

FD 65 

FD 26n 

2A dr ad 
ED 6B dr ad 
21 Io hi 

ED 47 

DD 2A dr ad 
DD 2A lo hi 
FD 2A dr ad 
FD 21 lo hi 
6E 

DD 6E d 
FD 6Ed 


wo w 


a CS 
o oO 
4 
7) 


Co @Oo oOo © @O© DO ON FSF FL HR HL HL LH FHL 


93 


94 


Instruction 
LDL,A 

LD L,B 
LDL,C 
LDL,D 

LD L,E 
LDL,H 

LD L,L 

LD L,n 

LD LIX,A 
LD LIX,B 
LD LIX,C 
LD LIX,D 
LD LIX,E 
LD LIX,HIX 
LD LIX,LIX 
LD LIX,n 
LD LIY,A 
LD LIY,B 
LD LIY,C 
LD LIY,D 
LD LIY,E 
LD LIY,HIY 
LD LIY,LIY 
LD LIY,n 
LD R,A 
LD SP,(addr) 
LD SP, hilo 
LD SP,HL 
LD SP,IX 
LD SP,IY 
LDD 
LDDR 

LDI 

LDIR 
NEG 

NOP 

OR (HL) 
OR (IX+d) 


Opcode 
6F 
68 
69 
6A 
6B 
6C 
6D 
2En 
DD 6F 
DD 68 
DD 69 
DD 6A 
DD 6B 
DD 6C 
DD 6D 
DD 2E n 
FD 6F 
FD 68 
FD 69 
FD 6A 
FD 6B 
FD 6C 
FD 6D 
FD 2En 
ED 4F 
ED 7B dr ad 
31 Io hi 
FQ 
DD F9 
FD F9 
ED A8& 
ED B8 
ED AO 
ED BO 
ED 44 
00 
B6 
DD B6 d 


Ts 


co @©o© oOo © © O Oo N Ff FH HR HL HR LH AL 


10 

10 

16 
z16nz21 
16 
zl6nz21 
8 

4 

7 

19 


A80 
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Instruction Opcode 
OR (lY+d) FD B6 d 
ORA B7 
ORB BO 
ORC B1 
ORD B2 
ORE B3 
ORH B4 
OR HIX DD B4 
OR HIY FD B4 
ORL B5 
OR LIX DD B5 
OR LIY FD B5 
ORn F6n 
OTDR ED BB 
OTIR ED B3 
OUT (C),A ED 79 
OUT (C),B ED 41 
OUT (C),C ED 49 
OUT (C),D ED 51 
OUT (C),E ED 59 
OUT (C),H ED 61 
OUT (C),L ED 69 
OUT (n),A D3 n 
OUTD ED AB 
OUTI ED A3 
POP AF F1 
POP BC C1 
POP DE D1 
POP HL E1 
POP IX DD E1 
POP IY FD E1 
PUSH AF F5 
PUSH BC C5 
PUSH DE D5 
PUSH HL E5 
PUSH IX DD E5 
PUSH IY FD E5 
RES 0,(HL) CB 86 


NM MO NO NB NBO YB NYO NYP NY NPY NY NY YB YB NY =| 


= 


NO NO ND 


Ts 


= 
<o} 


N © ©O F DO WO Ff FL HL HR HLH F 


z16nz21 
zl6nz21 
12 

12 

12 

12 

12 

12 


iia ns © © SE © SE © SE © © ES © DE © EE © © EE © EE © EE ©) 
UV 


~" 
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> © ee ee © ee © ee © ee © ee) 
i?) 


95 


96 


Instruction Opcode B Ts Ss Zz 
RES 0,(IX+d) DDCBd86 4 23 - - - 
RES 0,(IY+d) FDCBd86 4 23 - - - 


RES 0,A 
RES 0,B 
RES 0,C 
RES 0,D 
RES 0,E 
RES 0,H 
RES 0,L 


RES 1,(HL) CB 8E 
RES 1,(IX+d) DD CB d 8E 
RES 1,(IY+d) FD CBd8E 


RES 1,A 
RES 1,B 
RES 1,C 
RES 1,D 
RES 1,E 
RES 1,H 
RES 1,L 


RES 2,(HL) CB 96 
RES 2,(IX+d) DD CBd96 
RES 2,(IY+d) FD CBd96 


RES 2,A 
RES 2,B 
RES 2,C 
RES 2,D 
RES 2,E 
RES 2,H 
RES 2,L 


RES 3,(HL) CB 9E 
RES 3,(IXtd) DD CBd9E 
RES 3,(IY+d) FD CBd9E 


RES 3,A 
RES 3,B 
RES 3,C 
RES 3,D 
RES 3,E 
RES 3,H 


CB 87 
CB 80 
CB 81 
CB 82 
CB 83 
CB 81 
CB 85 


CB 8F 
CB 88 
CB 89 
CB 8A 
CB 8B 
CB 8C 
CB 8D 


CB 97 
CB 90 
CB 91 
CB 92 
CB 93 
CB 94 
CB 95 


CB 9F 
CB 98 
CB 99 
CB 9A 
CB 9B 
CB 9C 


MO MO NM NHB YB YB FP FP NYY YB YB YB YB YP YB YO FP F NY YB YB YB YB YB YB YO FP FPF NB YB YB NB NYO NY NM ND 
NO 
wo 
' 
1 
t 
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Instruction Opcode B 
CB 9D 2 8 7 = - 

RES 4,(HL) CBA6 2 
RES 4,(IX+d) DDCBdA6 4 23 - = s 
RES 4,(IY+d) FDCBdA6 4 23 2 2 é 


RES 3,L 


RES 4,A 
RES 4,B 
RES 4,C 
RES 4,D 
RES 4,E 
RES 4,H 
RES 4,L 


RES 5,(HL) CBAE 
RES 5,(IX+d) DDCBdAE 4 23 we 
RES 5,(lY+d) FDCBdAE 4 23 Be eo NS 


RES 5,A 
RES 5,B 
RES 5,C 
RES 5,D 
RES 5,E 
RES 5,H 
RES 5,L 


RES 6,(HL) CB B6 


RES 6,(IX+d) DDCBdB6 4 23 a 
RES 6,(lY+d) FDCBdB6 4 23 a 
RES 6,A CB B7 28 2 =< 
RES 6,B CB BO 2 8 5. i & 
RES 6,C CB B1 2 8 x Es 
RES 6,D CB B2 O: 8 ~  & & 
RES 6,E CB B3 2 8 = 2. 2 
RES 6,H CB B4 2 8 . &° 
RES 6,L CB B5 a 8 a ae 
RES 7,(HL) CBBE 2 15 oe 


RES 7,(IX+d) DDCBdBE 4 23 - 3 7 
RES 7,(IY+d) FDCBdBE 4 23 - : - 


RES 7,A 
RES 7,B 
RES 7,C 
RES 7,D 


CB A7 2 
CB AO 2 
CB A1 2 
CB A2 2 
CB A3 2 
CB A4 2 
CB AS 2 

2 


CB AF 2 
CB A8 2 
CB AQ 2 
CB AA 2 
CB AB 2 
CB AC 2 
CB AD 2 

2 


CB BF 2 8 - - - 
CB B8 2 8 - - - 
CB B9 2 8 - - - 
CB BA 2 8 - - - 
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97 


98 


Instruction Opcode 
RES 7,E CB BB 
RES 7,H CB BC 
RES 7,L CB BD 
RET Cg 
RET C D8 
RET M F8 
RET NC DO 
RET NZ 0) 

RET P FO 

RET PE E8 

RET PO EO 

RET Z C8 

RETI ED 4D 
RETN ED 45 

RL (HL) CB 16 

RL (IX+d) DD CB d 16 
RL (IY+d) FD CB d 16 
RLA CB 17 

RL B CB 10 

RL C CB 11 

RL D CB 12 
RLE CB 13 

RL H CB 14 

RLL CB 15 

RLA 17 

RLC (HL) CB 06 

RLC (IX+d) DD CB d 06 
RLC (IY+d) FD CB d 06 
RLC A CB 07 

RLC B CB 00 

RLC C CB 01 

RLC D CB 02 

RLC E CB 03 

RLC H CB 04 

RLC L CB 05 
RLCA 07 

RLD ED 6F 

RR (HL) CB 1E 


NN NY OW 


MO NBO NYO NHB YB NY YO HP FH NY NY NDB 


= 


MO DMO NO NHB YB YB YO HK FS ND 


Ts 


&- © ©O© © GO© WO GW @ 


hm NO = 
Oo wo ol 


- © © © © WO C&O @ 


ak x 
oOo © 


oN NNN NNN NNN! 


NN WN NNN NNN 


Ot © © Re © SE © © SE © EE © SE © ©) ' ORs © Re © © © Ss © Ss © EE © EE © SE) ! 


TCT DB 
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Instruction 
RR (IX+d) 
RR (lY+d) 
RRA 
RRB 
RRC 
RR D 
RRE 
RRH 
RRL 

RRA 

RRC (HL) 
RRC (IX+d) 
RRC (IY+d) 
RRC A 
RRC B 
RRC C 
RRC D 
RRC E 
RRC H 
RRC L 
RRCA 
RRD 
RST 0 

RST 1,addr 
RST 2,addr 
RST 3,addr 
RST 4 
RST 5,addr 
RST 6 
RST 7 

SBC A,(HL) 
SBC A,(IX+d) 
SBC A,(lY+d) 
SBC A,A 
SBC A,B 
SBC A,C 
SBC A,D 
SBC A,E 


Opcode 
DD CB d 1E 
FD CBd1E 
CB 1F 
CB 18 
CB 19 
CB 1A 
CB 1B 
CB 1C 
CB 1D 
1F 
CB OE 
DD CB d OE 
FD CB d OE 
CB OF 
CB 08 
CB 09 
CB OA 
CB 0B 
CB 0C 
CB 0D 
OF 
ED 67 
C7 
CF dr ad 
D7 dr ad 
DF dr ad 
E7 
EF dr ad 
F7 
FF 
9E 
DD 9E d 
FD 9E d 
OF 
98 
99 
9A 
9B 


4 


4 
4 


NO N 

Oo WwW 
4 
7) 


& CO co @oO @oO© &O C&O Oo 


NO NO = 
Oo wo on 


- © @O© O© © © WO 


= 
foe) 


oN NNN NNN NN 


NNN NNNNNN WN 


NN WNN NNN WN 


on © © RE © SE © EE © SE © EE © RE © ©) : Ot © © © SE © © EE © SE © RE ©) 


ne) 
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Tr TT TF TF TF oF ft 


99 


Instruction 
SBC A,H 
SBC A,HIX 
SBC A,HIY 
SBC A,L 
SBC A, LIX 
SBC A,LIY 
SBC A,n 
SBC HL,BC 
SBC HL,DE 
SBC HL,HL 
SBC HL,SP 
SCF 
SET 0,(HL) 
SET 0,(IX+d) 
SET 0,(IY+d) 
SET 0,A 
SET 0,B 
SET 0,C 
SET 0,D 
SET 0,E 
SET 0,H 
SET 0,L 
SET 1,(HL) 
SET 1,(IX+d) 
SET 1,(IY+d) 
SET 1,A 
SET 1,B 
SET 1,C 
SET 1,D 
SET 1,E 
SET 1,H 
SET 1,L 
SET 2,(HL) 
SET 2,(IX+d) 
SET 2,(IY+d) 
SET 2,A 
SET 2,B 
SET 2,C 
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Opcode 
9C 
DD 9C 
FD 9C 
9D 
DD 9D 
FD 9D 
DEn 
ED 42 
ED 52 
ED 62 
ED 72 
37 
CB C6 
DD CB d C6 
FD CB d C6 
CB C7 
CB CO 
CB C1 
CB C2 
CB C3 
CB C4 
CB C5 
CB CE 
DD CB d CE 
FD CB d CE 
CB CF 
CB C8 
CB C9 
CB CA 
CB CB 
CB CC 
CB CD 
CB D6 
DD CB d D6 
FD CB d D6 
CB D7 
CB DO 
CB D1 


MO MO NB NHB HB NY ND 


4 


4 


Ts 


NN WN NNN 


Tr TD TF TF TF TF TF TF FF fF 


= 


i?) 


Instruction Opcode 
SET 2,D CB D2 
SET 2,E CB D3 
SET 2,H CB D4 
SET 2,L CB D5 
SET 3,(HL) CB DE 
SET 3,(IX+d) DD CBdDE 
SET 3,(IY+d) FD CBdDE 
SET 3,A CB DF 
SET 3,B CB D8 
SET 3,C CB D9 
SET 3,D CB DA 
SET 3,E CB DB 
SET 3,H CB DC 
SET 3,L CB DD 
SET 4,(HL) CB E6 
SET 4,(IX+d) DD CBdE6 
SET 4,(IY+d) FD CBdE6 
SET 4,A CB E7 
SET 4,B CB EO 
SET 4,C CB E1 
SET 4,D CB E2 
SET 4,E CB E3 
SET 4,H CB E4 
SET 4,L CB E5 
SET 5,(HL) CB EE 
SET 5,(IX+d) DD CBdEE 
SET 5,(IY+d) FDCBdEE 
SET 5,A CB EF 
SET 5,B CB E8 
SET 5,C CB EQ 
SET 5,D CB EA 
SET 5,E CB EB 
SET 5,H CB EC 
SET 5,L CB ED 
SET 6,(HL) CB F6 


SET 6,(IXtd) DD CBdF6 
SET 6,(IYtd) FD CBdF6 


SET 6,A 


CB F7 
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NNN NY ND DW 


4 
4 


4 
4 


4 
4 


4 
4 
2 
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Instruction Opcode 


Ts ) Z 


SET 6,B CB FO 8 ee Oe 
SET 6,C CB F1 8 a ee 
SET 6,D CB F2 8 an 
SET 6,E CB F3 8 er 
SET 6,H CB F4 8 — “er Ob 
SET 6L CBF5 8 S ak |S 
SET 7,(HL) CBFE 15 2. lat ke 


SET 7,(IXtd) DD CBdFE 
SET 7,(IY+d) FD CBdFE 


SET 7,A 
SET 7,B 
SET 7,C 
SET 7,D 
SET 7,E 
SET 7,H 
SET 7,L 
SLA (HL) 


B 
2 
2 
2 
2 
2 
2 
y) 
4 
4 
2 
2 
2 
2 
2 
2 
2 
2 

SLA (IX+d) DDCBd26 4 

SLA (IY+d) FDCBd26 4 23 

2 
2 
2 
2 
2 
2 
2 
2 
4 
4 
2 
2 
2 
2 
2 
2 
2 
2 
4 


SLA A 
SLAB 
SLAC 
SLA D 
SLA E 
SLAH 
SLA L 
SLL (HL) 
SLL (IX+d) 
SLL (IY+d) 
SLLA 
SLL B 
SLLC 
SLL D 
SLLE 
SLLH 
SLLL 
SRA (HL) 
SRA (IX+d 


CB FF 
CB F8 
CB FQ 
CB FA 
CB FB 
CB FC 
CB FD 
CB 26 


CB 27 
CB 20 
CB 21 
CB 22 
CB 23 
CB 24 
CB 25 
CB 36 
DD CB d 36 
FD CBd 36 
CB 37 
CB 30 
CB 31 
CB 32 
CB 33 
CB 34 
CB 35 
CB 2E 
) DDCBd2E 


NN NNwNNNNNNNNNNNNNNNNN ON 
cD UO DUT TCU THU TOC TCC TCU WUC TO TT TT HTT HThU TUTTUCUOHTCUC]HMhUC 
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Instruction Opcode B Ts S) Zz P Cc 
SRA (I¥Y+d) FDCBd2E 4 23 7 Zz p r0 
SRA A CB 2F 2 8 7 z p r0 
SRA B CB 28 2 8 7 z p r0 
SRA C CB 29 2 8 7 Zz p r0 
SRA D CB 2A 2 8 7 z p r0 
SRAE CB 2B 2 8 7 Zz p r0 
SRA H CB 2C 2 8 7 Zz p r0 
SRAL CB 2D 2 8 7 Zz p r0 
SRL (HL) CB 3E 2 15 7 Zz p r0 
SRL (IX+d) DDCBd3E 4 23 7 Zz p r0 
SRL (lY+d) FDCBd3E 4 23 7 Zz p r0 
SRLA CB 3F 2 8 7 Zz p r0 
SRL B CB 38 2 8 7 Zz p r0 
SRL C CB 39 2 8 7 Zz p r0 
SRL D CB 3A 2 8 7 Zz p r0 
SRLE CB 3B 2 8 7 Zz p r0 
SRL H CB 3C 2 8 7 Zz p r0 
SRLL CB 3D 2 8 7 Zz p r0 
SUB (HL) 96 1 7 7 Zz Vv b 
SUB (IX+d) DD96d 3 19 7 Zz Vv b 
SUB (IY+d) FD96d 3 19 7 Zz Vv b 
SUB A 97 1 4 7 Zz Vv b 
SUB B 90 1 4 7 Zz Vv b 
SUB C 91 1 4 7 z Vv b 
SUB D 92 1 4 7 z Vv b 
SUB E 93 14 7 z Vv b 
SUB H 94 1 4 7 z Vv b 
SUB HIX DD AC 2 8 7 Zz Vv b 
SUB HIY FD AC 2 8 7 z Vv b 
SUB L 95 1 4 7 Zz Vv b 
SUB LIX DD AD 2 8 7 z Vv b 
SUB LIY FD AD 2 8 7 z Vv b 
SUB n D6 n 27 7 Zz Vv b 
XOR (HL) AE 1 7 7 Zz p 0 
XOR (IX+d) DDACd 3 19 7 Zz p 0 
XOR (lYt+d) FDACd 3 19 7 Zz p 0 
XORA AF 1 4 7 z p 0 
XOR B A8 1 4 7 Zz p 0 
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Instruction Opcode B Ts Ss Zz 


XOR C 
XOR D 
XORE 
XOR H 
XOR HIX 
XOR HIY 
XORL 
XOR LIX 
XOR LIY 
XOR n 


AQ 1 (4 7 z p 
AA 1 (4 7 z p 
AB 14 7 z p 
AC 1 4 7 Zz p 
DD AC 2 8 7 Zz p 
FD AD 2 8 7 Zz p 
AD 1 (4 7 z p 
DD AC 2 8 7 z p 
FD AD 2 8 7 z p 
EEn 2 7 7 z p 
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The CRTC Registers 


To change the value of these registers, the register number should be output on address &BCxx and 
then the data output on &BDxx 


Reg Function Default Value Reg Function Default Value 
RO Horizontal Total 63 R1 Horizontal Displayed 40 

R2 Horizontal Sync Pos. 46 R3 = Sync Width 112 

R4 Vertical Total 38 R5_—‘~Vertical Total Adjust 0 

R6 Vertical Displayed 25 R7 Vertical Sync Position 30 

R8  Interlace and Skew 0 RQ Maximum Raster Addr 7 

R10 Cursor Start Raster 0 R11 Cursor End Raster 0 

R12 Start Address (H) 48 R13 Start Address (L) 0 

R14 Cursor Register (H) 192 R15 Cursor Register (L) 07 
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